Senden Sie Chat-Anfragen mit OAuth

Wählen Sie diesen Weg, wenn ein Kunde Ihrer Anwendung die Nutzung seines ausgewählten ShareAI-Kontos autorisiert hat. Schließen Sie zuerst den Autorisierungscode mit PKCE ab und erhalten Sie eine Berechtigung, die Folgendes umfasst: surcharge.

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}'

Das Zugriffstoken wird im Bearer-Header verwendet#

Der Chat-Endpunkt und der Anfragetext sind identisch mit dem API-Key-Flow. Der Unterschied liegt in den Anmeldedaten und ihrem Autorisierungslebenszyklus. Ein Refresh-Token wird nur an den Token-Endpunkt gesendet; ein ID-Token wird nur für die validierte Anmeldung der Anwendung verwendet.

Wer zahlt und welcher Plan gilt?#

Die akzeptierte Berechtigung identifiziert das ausgewählte persönliche oder Organisationskonto, die Anwendung und den Nutzungsplan. Der Dienst bestimmt diese Werte aus der Autorisierung. Senden Sie keine Zahler-ID, keine Builder-Gebühr oder das Subjekt eines anderen Kunden im Chat-Body, um die Abrechnung zu ändern.

Zugriff erneuern, ohne die Zustimmung zu verlieren#

Wenn das Zugriffstoken abläuft, verwenden Sie den Refresh-Flow in Ihrem Backend und speichern Sie das Ersatz-Refresh-Token. Wenn die Berechtigung widerrufen wird oder eine neue Zustimmung erforderlich ist, verbinden Sie den Kunden über den Browser-Flow erneut.

Fehlerbehandlung#

Modellidentität und Ausführungsanbieter#

Kopieren Sie die genaue, auf dem Creator basierende Modellkennung von Modelle. Wählen Sie die Infrastruktur separat mit dem optionalen provider Objekt aus. Standardmäßig werden berechtigte Anbieter nach Preis sortiert, beginnend mit dem niedrigsten. Anbieter auswählen oder konsultieren Sie die vollständige Richtlinienreferenz.

Monatliche Ausgabelimits und Abrechnungswiederherstellung#

Jedes zahlende Konto kann sein eigenes monatliches KI-Ausgabelimit pro Anwendung oder Client-Service unter Abrechnung → Abonnements & Verpflichtungen festlegen. Das Limit umfasst Netzwerkkosten und Builder-Zuschläge, während feste Abonnements und bestätigte Käufe separat bleiben. Ein Limitfehler verwendet HTTP 402 application_spending_limit_exceeded; unzureichende berechtigte Guthaben verwenden HTTP 402 insufficient_credits. Beide bieten einen Kundenabrechnungslink. Fehlervertrag, Streaming-Verarbeitung und Integrationsbeispiel.