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.
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.
https://api.shareai.now/api/v1/chat/completionsExecute 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.
Renovar acesso sem perder consentimento#
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#
| Resultado | Ação |
|---|---|
401 consent_required | Peça ao cliente para se reconectar se a autorização não for mais válida. |
403 | Verifique a permissão de inferência concedida e o acesso permitido ao modelo/provedor. |
429 | Respeite o Retry-After e os limites da sua aplicação/conta. |
503 temporarily_unavailable | Mostre um erro de serviço temporário; não informe ao cliente que o consentimento foi revogado. |
Identidade do modelo e fornecedores de execução#
Copie o identificador exato do modelo baseado no Creator de Modelos. Selecione a infraestrutura separadamente com a opção provider objeto. O padrão classifica os fornecedores elegíveis pelo preço, do menor para o maior. Escolher fornecedores ou consulte a referência completa da política.
Limites mensais de gastos e recuperação de faturação#
Cada conta pagante pode definir o seu próprio limite mensal de gastos em IA por aplicação ou serviço de cliente em Faturação → Subscrições & Compromissos. O limite inclui o custo da rede e a sobretaxa do Builder, enquanto subscrições fixas e compras confirmadas permanecem separadas. Um erro de limite utiliza HTTP 402 application_spending_limit_exceeded; créditos elegíveis insuficientes utilizam HTTP 402 insufficient_credits. Ambos fornecem um link de faturação para o cliente. Exemplo de contrato de erro, gestão de streaming e integração.
Última atualização em 18 de setembro de 2026