Nutzung

Für Auslandsintegrationen lautet die stabile Kontoprüfung heute Profil. Verwenden Sie es, um Credits, Stufe und verbleibende API-Kontingente vor großen Operationen abzulesen. Dedizierte Nutzungsendpunkte sollten als schemagesteuert behandelt werden: Rufen Sie nur Pfade auf, die in GET /api/openapi.json vorhanden sind.

Anfrage

Das Profil verwendet eine normale, über den Inhaber authentifizierte Anfrage:

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

curl https://fishaudio.org/api/open/v1/profile \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

Antwort

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

Verwenden Sie die Antwort als betriebliche Leitplanke, nicht als Reservierung. Andere Arbeiter verbrauchen möglicherweise das Guthaben, nachdem Sie es überprüft haben.

Abrechnung und Gutschriften

Speichern Sie Bilanz-Snapshots rund um teure Chargen. Wenn Kunden fragen, warum ein Stapel gestoppt wurde, vergleichen Sie den Startprofil-Snapshot, die Anzahl der abgeschlossenen Jobs, die Anzahl der fehlgeschlagenen Jobs und den endgültigen Profil-Snapshot.

Fehler

Profilfehler folgen der gemeinsamen Fehlerform API. Wenn ein zukünftiger Nutzungsendpunkt im Schema erscheint, wenden Sie dieselben Wiederholungs- und Protokollierungsregeln an: Protokollieren Sie requestId, vermeiden Sie die Protokollierung von API-Schlüsseln und unterbrechen Sie die Batch-Erstellung bei unzureichenden Credits.