Dokumentaatio

Virheet / Käyttörajat

Virheet

HTTP-virheiden yhteydessä palautetaan error-objekti, jossa on kentät code ja message. Onnistuneesti vastaanotettu tehtävä voi silti epäonnistua myöhemmin; tee tehtäväkysely tai käsittele epäonnistumisesta tuleva webhook-kutsu.

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

HTTP	Kenttä	Toimenpide
400	`invalid_request`	Korjaa JSON-rakenne, puuttuva prompt-syöte, parametrien arvot tai median URL-osoite ennen uutta yritystä.
401	`invalid_api_key`	Tarkista Bearer-token ja varmista, että API-avain on aktiivinen.
402	`insufficient_credits`	Lisää krediittejä tai pienennä tehtävän kulua. Vastaus voi sisältää tiedon vaaditusta ja käytettävissä olevasta krediittimäärästä.
403	`forbidden`	Tarkista virheilmoituksessa mainittu tilitasoinen rajoitus.
404	`not_found`	Tarkista tehtävätunnus (task ID) ja varmista, että API-avain kuuluu tehtävän luoneelle käyttäjälle.
429	`rate_limited`	Odota Retry-After-otsikossa määritetty aika ennen kuin yrität uudelleen.
500	`internal_error`	Tarkista virheilmoitus ja API-logit. Yritä uudelleen harkiten; uuden luontipyynnön lähettäminen voi luoda uuden veloitettavan tehtävän.

Käyttörajat

Tehtävien luonti: kukin API-avain sallii oletusarvoisesti enintään 100 pyyntöä minuutissa. Mukautettuja pyyntörajoituksia ei ole tällä hetkellä saatavilla.

Tehtävien kyselyt: kukin API-avain sallii oletusarvoisesti enintään 120 pyyntöä minuutissa. Kyselypyynnöt ja tehtävien luontipyynnöt lasketaan erikseen.

Kuva- ja videopyynnöt jakavat saman API-avaimen kutsurajoituksen (rate limit).

Virhe HTTP 429 sisältää otsikon Retry-After: 60 luontipyynnöille ja Retry-After: 5 kyselyille. Käytä viivästettyjä uusintayrityksiä (backoff) ja vältä tarpeettoman tiheitä kyselyitä.

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

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