Referência de política de fornecedores

Consulte os campos, padrões, limites e erros do fornecedor ShareAI para escolher fornecedores de execução em pedidos de inferência.

Ver como Markdown

Nesta página

O opcional provider objeto pertence ao nível superior do pedido de inferência, juntamente com model. Um objeto vazio utiliza os padrões. É separado do Acesso Remoto do Fornecedor e das suas credenciais de gestão.

Campo	Tipo	Comportamento
`only`	array de etiquetas de fornecedores	Restringir a execução a estes fornecedores.
`ignore`	array de etiquetas de fornecedores	Excluir estes fornecedores, incluindo do fallback.
`order`	array de etiquetas de fornecedores	Classificar estes fornecedores primeiro na ordem fornecida; depois aplicar a ordenação.
`allow_fallbacks`	booleano; padrão true	Permitir outros fornecedores elegíveis. Com false e uma lista de ordem não vazia, apenas os fornecedores listados permanecem; sem ordem, apenas o fornecedor classificado em primeiro lugar permanece.
`networks`	array	Restringir tipos de fornecedores a comunidade, empresa e/ou shareai.
`sort`	string ou objeto	Usar preço, latência ou throughput, ou um objeto com by e direction.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

Substituir o placeholder por uma etiqueta de fornecedor em minúsculas real, ou remover o campo ignore. Os tipos de rede selecionam categorias de infraestrutura; não identificam criadores de modelos.

Ordenar padrões#

Ordenar	Direção padrão	Reverso explícito
`price`	`asc` — menor primeiro	`desc` — maior primeiro
`latency`	`asc` — menor tempo decorrido primeiro	`desc` — maior primeiro
`throughput`	`desc` — mais tokens de saída por segundo primeiro	`asc` — menos primeiro

Para um objeto, definir by para um destes nomes e direction para asc ou desc. Veja como funcionam as medições e o fallback.

Validação e erros#

Usar booleanos JSON e arrays de etiquetas de fornecedores em minúsculas. Não enviar null para fornecedor ou ordenação.
Apenas os campos listados são aceitos; isto não é uma implementação completa de parâmetros OpenRouter.
A política está limitada a 8 KiB. As listas only, ignore e order aceitam no máximo 100 etiquetas cada.
Políticas inválidas retornam HTTP 400. Escopos de credenciais proibidos retornam HTTP 403. Nenhum fornecedor elegível disponível retorna HTTP 503.

Uma política mínima#

JSON

{
  "provider": {
    "sort": "price"
  }
}

Quando omitida completamente, a seleção de fornecedores também tem como padrão a classificação determinística por preço ascendente. As restrições aplicam-se sempre antes da classificação.

Última atualização a 16 de setembro de 2026