Dokumentation

Felmeddelanden / Anropsbegränsningar

Felmeddelanden

HTTP-fel returnerar ett error-objekt med code och message. En uppgift som har tagits emot utan fel kan fortfarande misslyckas senare; kontrollera uppgiftens status eller hantera webhooken för misslyckade uppgifter.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Fält	Åtgärd
400	`invalid_request`	Korrigera din JSON, saknad prompt, felaktiga parametervärden eller medie-URL:er innan du försöker igen.
401	`invalid_api_key`	Kontrollera din Bearer-token och att API-nyckeln är aktiv.
402	`insufficient_credits`	Fyll på krediter eller minska uppgiftens kostnad. Svaret kan innehålla information om saldo som krävs samt ditt nuvarande saldo.
403	`forbidden`	Kontrollera kontobegränsningen som beskrivs i felmeddelandet.
404	`not_found`	Kontrollera uppgiftens ID och att API-nyckeln tillhör samma användare som skapade uppgiften.
429	`rate_limited`	Vänta den tid som anges i Retry-After innan du försöker igen.
500	`internal_error`	Kontrollera felmeddelandet och API-loggarna. Försök igen med försiktighet; att skicka om ett anrop kan skapa ytterligare en debiterbar uppgift.

Anropsbegränsningar

Skapa uppgifter: Varje API-nyckel tillåter som standard upp till 100 anrop per minut. Anpassade anropsgränser är inte tillgängliga för närvarande.

Söka uppgifter: Varje API-nyckel tillåter som standard upp till 120 anrop per minut. Sökanrop och anrop för att skapa uppgifter räknas separat.

Begäranden om bild- och videoskapande delar samma anropsbegränsning för API-nyckeln.

HTTP 429 returnerar Retry-After: 60 för skapande och Retry-After: 5 för statusfrågor. Använd gradvis fördröjning (backoff) och undvik att göra statuskontroller oftare än nödvändigt.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}