Search docs

Search the TryOnCloud API docs

API-Referenz

Credits anzeigen

GET /api/v1/credits: Verbleibende Anproben auf Ihrem Konto.

Code-Beispiele, Endpunkte und Fehlercodes sind in jeder Sprache identisch.

GET https://www.tryoncloud.com/api/v1/credits

Gibt zurück, wie viele Testläufe Ihr Konto noch ausführen kann – aus demselben Pool, aus dem auch POST /generate schöpft.

Anfrage

bash
curl https://www.tryoncloud.com/api/v1/credits -H "X-API-KEY: $TRYONCLOUD_API_KEY"

Antwort

json
{
  "credits_remaining": 4870,
  "purchased_remaining": 4870,
  "purchased_total": 5000,
  "free_remaining": 0,
  "spends_from": "purchased"
}
FeldBedeutung
credits_remainingAnproben, die Sie sofort durchführen können. Nutzen Sie diese hier
purchased_remainingVerbleibende gekaufte Credits (sie verfallen nie)
purchased_totalAlle jemals gekauften Credits
free_remainingVerbleibendes Gratisguthaben (wird nur vor Ihrem ersten Einkauf verwendet)
spends_frompurchased, sobald Sie Credits gekauft haben, andernfalls free_allowance

Tipps

  • Überprüfen Sie den Stand vor einer großen Datenverarbeitung und lassen Sie sich benachrichtigen, sobald credits_remaining unter den Verbrauch von einigen Tagen fällt.
  • Ratenbegrenzung: 60 Anfragen pro Minute und Schlüssel. Rufen Sie die Funktion nicht vor jedem Test auf; ein 402-Fehler von /generate zeigt Ihnen bereits an, wenn das Limit erreicht ist.
  • Kaufen Sie Guthaben auf der Seite „Abrechnung“ im Dashboard.

Fehler

HTTPCodeBedeutung
401NO_KEY, INVALID_KEYFehlender oder falscher Schlüssel
429RATE_LIMITEDÜber 60 Anfragen pro Minute
500CREDITS_UNAVAILABLEVorübergehendes Problem, bitte versuchen Sie es erneut