ShareAI Platform Docs

Envie solicitações de chat com OAuth

Use um token de acesso OAuth ShareAI aprovado para conclusões de chat financiadas pelo cliente e gerencie a expiração do token, consentimento e limites de conta.

Ver como Markdown
Nesta página

Escolha este caminho quando um cliente tiver autorizado a sua aplicação a usar a conta ShareAI selecionada. Primeiro, complete o código de autorização com PKCE e obtenha uma concessão que inclua surcharge.

POST https://api.shareai.now/api/v1/chat/completions

Execute inferências sob o acordo de aplicação aceito pelo cliente.

URL Base
https://api.shareai.now
Autenticação
Token de acesso OAuth Bearer
Escopo necessário
surcharge

cURL

curl --fail-with-body https://api.shareai.now/api/v1/chat/completions \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"model":"MODEL_IDENTIFIER","messages":[{"role":"user","content":"Hello!"}],"stream":false}'

O token de acesso vai no cabeçalho Bearer#

O endpoint de chat e o corpo da solicitação são os mesmos do fluxo de chave API. A diferença está na credencial e no ciclo de vida da autorização. Um token de atualização é enviado apenas para o endpoint de token; um token de ID é usado apenas para login validado na aplicação.

Quem paga e qual plano se aplica?#

A concessão aceita identifica a conta pessoal ou organizacional selecionada, a aplicação e o plano de uso. O serviço determina esses valores a partir da autorização. Não envie um ID de pagador, taxa do Builder ou o assunto de outro cliente no corpo do chat para alterar a cobrança.

Quando o token de acesso expirar, use o fluxo de atualização no seu backend e armazene o token de atualização substituto. Quando a concessão for revogada ou for necessário um novo consentimento, reconecte o cliente através do fluxo do navegador.

Gestão de falhas#

ResultadoAção
401 consent_requiredPeça ao cliente para se reconectar se a autorização não for mais válida.
403Verifique a permissão de inferência concedida e o acesso permitido ao modelo/provedor.
429Respeite o Retry-After e os limites da sua aplicação/conta.
503 temporarily_unavailableMostre um erro de serviço temporário; não informe ao cliente que o consentimento foi revogado.

Última atualização em 15 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