ShareAI Platform Docs

Escolher fornecedores de execução para um pedido de API

Utilize o objeto de fornecedor ShareAI para selecionar fornecedores de execução independentemente do criador de um modelo em todos os quatro endpoints de inferência.

Ver como Markdown
Nesta página

Defina model ao identificador exato baseado no criador. Adicione provider quando quiser restringir ou classificar a infraestrutura elegível para executar a solicitação. Omitir isso utiliza a política padrão de menor preço.

Use um fornecedor#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/chat/completions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "provider": {
    "only": [
      "shareai"
    ],
    "allow_fallbacks": false
  },
  "model": "openai/gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Explain model routing in one sentence."
    }
  ]
}'

Use as etiquetas de fornecedor exibidas para o modelo selecionado. only é uma restrição rígida: permitir alternativas nunca autoriza um fornecedor fora desta lista.

Use a mesma política em cada endpoint de inferência#

Ponto de extremidadeCampo principal de entradaEscolha um modelo que suporte
/api/v1/chat/completionsmessagesConclusão de chat
/api/v1/responsesinputRespostas
/api/v1/embeddingsinputEmbeddings
/api/v1/images/generationspromptGeração de imagens

A política de fornecedor tem o mesmo significado nesses endpoints. As capacidades de modelo e fornecedor diferem: um modelo de chat não é automaticamente um modelo de embeddings ou de imagens. Copie um identificador elegível para a operação do catálogo; endpoints nativos exigem suporte configurado.

Prefira fornecedores nomeados#

JSON

{
  "provider": {
    "order": [
      "PROVIDER_A",
      "PROVIDER_B"
    ],
    "allow_fallbacks": false,
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  }
}

Substituir PROVIDER_A and PROVIDER_B com etiquetas reais de fornecedor em minúsculas. Com esta lista ordenada e alternativas desativadas, apenas os fornecedores listados são elegíveis, nessa ordem. O segundo fornecedor listado ainda pode ser selecionado se o primeiro não estiver disponível.

Mantenha as restrições de credenciais#

Sua solicitação pode restringir os modelos e fornecedores permitidos por uma chave de API. Ela não pode conceder acesso fora dessas permissões. O consentimento OAuth, a elegibilidade de faturamento e a disponibilidade do dispositivo continuam a ser aplicáveis.

Próximo#

Cada campo de fornecedor · Ordem de classificação e comportamento de alternativas

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

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI