Trimite cereri de chat cu OAuth
Utilizează un token de acces OAuth ShareAI aprobat pentru completări chat finanțate de client și gestionează expirarea tokenului, consimțământul și limitele contului.
Pe această pagină
Alege această cale atunci când un client a autorizat aplicația ta să utilizeze contul său ShareAI selectat. Mai întâi finalizează codul de autorizare cu PKCE și obține un grant care include surcharge.
https://api.shareai.now/api/v1/chat/completionsRulează inferența conform acordului de aplicație acceptat de client.
- URL de bază
https://api.shareai.now- Autentificare
- Token de acces OAuth Bearer
- Scop necesar
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}'
Tokenul de acces se află în antetul Bearer#
Endpoint-ul de chat și corpul cererii sunt aceleași ca în fluxul cu cheie API. Diferența constă în acreditiv și ciclul său de viață al autorizării. Un token de reîmprospătare este trimis doar la endpoint-ul token; un token ID este utilizat doar pentru autentificarea validată a aplicației.
Cine plătește și ce plan se aplică?#
Grantul acceptat identifică contul personal sau organizațional selectat, aplicația și planul de utilizare. Serviciul determină aceste valori din autorizare. Nu trimite un ID de plătitor, o taxă pentru Builder sau subiectul altui client în corpul chat-ului pentru a schimba facturarea.
Reînnoiește accesul fără a pierde consimțământul#
Când token-ul de acces expiră, folosește fluxul de reîmprospătare pe backend-ul tău și stochează token-ul de reîmprospătare înlocuitor. Când grantul este revocat sau este necesar un nou consimțământ, reconectează clientul prin fluxul de browser.
Gestionarea erorilor#
| Rezultat | Acțiune |
|---|---|
401 consent_required | Cere clientului să se reconecteze dacă autorizarea nu mai este validă. |
403 | Verifică permisiunea de inferență acordată și accesul permis la model/provizor. |
429 | Respectă Retry-After și limitele aplicației/contului tău. |
503 temporarily_unavailable | Afișează o eroare temporară a serviciului; nu spune clientului că consimțământul a fost revocat. |
Ultima actualizare: 15 septembrie 2026