ShareAI Platform Docs

Envía solicitudes de chat con OAuth

Usa un token de acceso OAuth aprobado de ShareAI para finalizaciones de chat financiadas por el cliente y maneja la expiración del token, el consentimiento y los límites de cuenta.

Ver como Markdown
En esta página

Elige este camino cuando un cliente haya autorizado tu aplicación para usar su cuenta de ShareAI seleccionada. Primero completa el código de autorización con PKCE y obtén una concesión que incluya surcharge.

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

Ejecuta inferencias bajo el acuerdo de aplicación aceptado por el cliente.

URL base
https://api.shareai.now
Autenticación
Token de acceso OAuth Bearer
Alcance requerido
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}'

El token de acceso va en el encabezado Bearer#

El endpoint de chat y el cuerpo de la solicitud son los mismos que en el flujo de clave API. La diferencia está en la credencial y su ciclo de vida de autorización. Un token de actualización se envía solo al endpoint de token; un token de ID se usa únicamente para el inicio de sesión validado de la aplicación.

¿Quién paga y qué plan se aplica?#

La concesión aceptada identifica la cuenta personal u organizacional seleccionada, la aplicación y el plan de uso. El servicio determina esos valores a partir de la autorización. No envíes un ID de pagador, tarifa del Builder u otro sujeto del cliente en el cuerpo del chat para cambiar la facturación.

Cuando el token de acceso expire, utiliza el flujo de actualización en tu backend y almacena el token de actualización de reemplazo. Cuando la concesión sea revocada o se requiera un nuevo consentimiento, reconecta al cliente a través del flujo del navegador.

Manejo de fallos#

ResultadoAcción
401 consent_requiredPide al cliente que se reconecte si la autorización ya no es válida.
403Verifica el permiso de inferencia concedido y el acceso permitido al modelo/proveedor.
429Respeta Retry-After y los límites de tu aplicación/cuenta.
503 temporarily_unavailableMuestra un error temporal del servicio; no le digas al cliente que el consentimiento fue revocado.

Última actualización septiembre 15, 2026

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI