aisplice

API-Referenz

Guthaben

GET/v1/balance

Gibt das Kontoguthaben und den Betrag zurück, den der aufrufende API-Schlüssel noch ausgeben kann, in USD. Kostenlos und nur lesend: kein Modellaufruf, keine Abrechnung. Aufgebrauchte oder abgelaufene Schlüssel können ihn weiterhin aufrufen; nur deaktivierte Schlüssel werden abgelehnt.

#Anfrageparameter

  • Authorizationheadererforderlich

    Bearer sk-YOUR_KEY. Es gibt keinen Body und keine Query-Parameter.

balance ist das Wallet des gesamten Kontos und kann nach der Verrechnung eines großen Jobs unter null fallen. available ist, was dieser Schlüssel jetzt ausgeben kann: der kleinere Wert aus balance und dem eigenen Restlimit des Schlüssels, nie unter null. key.remaining ist null, wenn der Schlüssel kein eigenes Limit hat; expires_at 0 bedeutet, dass er nie abläuft.

B2B-Aufrufer können den Endpunkt vor dem Senden von Aufträgen abfragen und ihr Team warnen, wenn available knapp wird. Bei aktivierter Anfragesignierung signieren Sie ihn wie jeden anderen Aufruf mit diesem Schlüssel, mit dem Pfad /v1/balance.

#Zugehörige Fehler

  • 401Fehlender, ungültiger oder deaktivierter Schlüssel — oder bei aktivierter Anfragesignierung eine fehlende oder falsche Signatur.
  • 403Das Konto ist deaktiviert.
  • 500Das Guthaben konnte nicht gelesen werden. Versuchen Sie es in einigen Sekunden erneut.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#Antwort

response.json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückDatei-Upload-PolicyWeiterModellliste