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. |
Identitatea modelului și furnizorii de execuție#
Copiază identificatorul exact al modelului bazat pe creator din Modele. Selectează infrastructura separat cu opțiunea provider obiect. Implicit, furnizorii eligibili sunt clasificați după preț, de la cel mai mic. Alege furnizori sau consultă referința completă a politicii.
Limite lunare de cheltuieli și recuperare facturare#
Fiecare cont plătitor poate seta propriul plafon lunar de cheltuieli AI per aplicație sau serviciu client în Facturare → Abonamente & Angajamente. Plafonul include costul rețelei și suprataxa Builder, în timp ce abonamentele fixe și achizițiile confirmate rămân separate. O eroare de plafon utilizează HTTP 402 application_spending_limit_exceeded; credite eligibile insuficiente utilizează HTTP 402 insufficient_credits. Ambele oferă un link de facturare pentru client. Contract de eroare, gestionarea streamingului și exemplu de integrare.
Ultima actualizare septembrie 18, 2026