Profil

Verwenden Sie Profilendpunkte, um die Konto-ID, die Stufe, das Guthaben und das verbleibende API-Kontingent des API-Schlüsselbesitzers zu überprüfen. Rufen Sie diesen Endpunkt vor großen Chargen, nach wichtigen Aufträgen und während Betriebsprüfungen auf.

Profil abrufen

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

Anfrage

Für die Anfrage ist kein Textkörper erforderlich.

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

Antwort

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

Behandeln Sie unbekannte Felder als additiv und vermeiden Sie das Scheitern strenger Parser, wenn die Antwort neue Konto- oder Abrechnungsmetadaten erhält.

Profil aktualisieren

POST /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

{
  "webhookUrl": "https://example.com/webhooks/fishspeech"
}

Die aktualisierbaren Felder werden vom Server gesteuert. Unbekannte Felder können ignoriert oder abgelehnt werden. Halten Sie Profilaktualisierungen von der Medienauftragserstellung getrennt, damit ein Profilvalidierungsfehler nicht verwandte Generierungsarbeiten nicht blockieren kann.

Abrechnung und Gutschriften

Der Profilendpunkt ist die sicherste einfache Prüfung vor einem Batch. Es kann anzeigen, ob das Konto wahrscheinlich über genügend Guthaben oder Kontingent für den nächsten Vorgang verfügt, es handelt sich jedoch nicht um ein Reservierungssystem. Zwischen Ihrem Scheck und der Medienanfrage kann es sein, dass andere Arbeitnehmer den Restbetrag verbrauchen.

Speichern Sie für kritische Arbeitsabläufe den Profil-Snapshot mit der Batch-ID. Wenn ein Job später aus Kontingentgründen fehlschlägt, hilft Ihnen dieser Snapshot dabei, einen bereits vorhandenen niedrigen Saldo von der gleichzeitigen Nutzung durch einen anderen Prozess zu unterscheiden.

Fehler