Documentatie

Foutmeldingen / Rate limits

Foutmeldingen

HTTP-fouten bevatten een error-object met een code en message. Een succesvol geaccepteerde taak kan later alsnog mislukken; vraag de taak op of handel de fout af via de callback.

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

HTTP	Veld	Wat te doen
400	`invalid_request`	Corrigeer de JSON, de ontbrekende prompt, het parameterbereik of de media-URL voordat je het opnieuw probeert.
401	`invalid_api_key`	Controleer het Bearer-token en of de API-sleutel actief is.
402	`insufficient_credits`	Waardeer je credits op of verlaag de kosten van de taak. De response kan de vereiste en beschikbare hoeveelheden bevatten.
403	`forbidden`	Controleer de beperking op accountniveau die in de foutmelding wordt beschreven.
404	`not_found`	Controleer de taak-ID en of de sleutel hoort bij de gebruiker van de taak.
429	`rate_limited`	Wacht tot het Retry-After-interval is verstreken voordat je het opnieuw probeert.
500	`internal_error`	Controleer de foutmelding en de API-logs. Wees voorzichtig met opnieuw proberen; het opnieuw verzenden van een aanmaak-request kan leiden tot een nieuwe factureerbare taak.

Rate limits

Taken aanmaken: elke API-sleutel staat standaard maximaal 100 verzoeken per minuut toe. Aangepaste limieten zijn momenteel niet beschikbaar.

Taken opvragen: elke API-sleutel staat standaard maximaal 120 verzoeken per minuut toe. Zoekopdrachten en verzoeken voor het aanmaken van taken worden apart geteld.

Aanvragen voor het genereren van afbeeldingen en video's delen dezelfde limiet (rate limit) per API-sleutel.

HTTP 429 bevat Retry-After: 60 voor het aanmaken en Retry-After: 5 voor queries. Bouw een vertraging in en vermijd vaker pollen dan nodig is.

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

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