Dokumentasjon

Feilmeldinger / Grenser for forespørsler (rate limits)

Feilmeldinger

HTTP-feil returnerer et error-objekt med code og message. En oppgave som ble mottatt uten feil, kan fortsatt mislykkes senere; sjekk status på oppgaven eller håndter feil via callback.

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

HTTP	Felt	Løsning
400	`invalid_request`	Rett opp feil i JSON-strukturen, manglende prompt, feil parameterverdier eller ugyldige medie-URL-er før du prøver igjen.
401	`invalid_api_key`	Kontroller Bearer-tokenet og sjekk om API-nøkkelen er aktiv.
402	`insufficient_credits`	Fyll på kreditter eller reduser kostnaden for oppgaven. Svaret kan inneholde opplysninger om nødvendig og tilgjengelig saldo.
403	`forbidden`	Sjekk kontobegrensningen som er beskrevet i feilmeldingen.
404	`not_found`	Kontroller oppgave-ID-en og at nøkkelen tilhører eieren av oppgaven.
429	`rate_limited`	Vent i tidsrommet angitt i Retry-After før du prøver igjen.
500	`internal_error`	Undersøk feilmeldingen og API-loggene. Prøv igjen med forsiktighet; en ny innsending av forespørselen kan opprette en ny, betalbar oppgave.

Grenser for forespørsler (rate limits)

Opprett oppgaver: Hver API-nøkkel tillater som standard opptil 100 forespørsler i minuttet. Skreddersydde ratebegrensninger er foreløpig ikke tilgjengelig.

Hent oppgaver: Hver API-nøkkel tillater som standard opptil 120 forespørsler i minuttet. Forespørsler om opphenting og oppretting av oppgaver telles hver for seg.

Forespørsler om opprettelse av bilder og videoer deler samme hastighetsbegrensning (rate limit) for API-nøkkelen.

HTTP 429 inkluderer Retry-After: 60 for opprettelse og Retry-After: 5 for statusspørringer. Bruk gradvis økende ventetid (backoff) og unngå unødvendig hyppig polling.

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

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