Referenssi · Virheet

Photta API -virheet kaikki tyypit ja toimintaohjeet

Yhdellä lauseella

Jokainen Photta API -virhe palauttaa saman rakenteen: statuskoodin, kentän `error.type`, viestin ja kentän `request_id`. Yritä virhettä 429 uudelleen Retry-After-otsakkeen jälkeen ja virheitä 5xx backoff-viiveellä; korjaa virheet 400, 401 ja 402 omassa koodissasi.

Hanki API-avainLue dokumentaatio
  • Virheet: 7 virhetyyppiä
  • Retry-After: Retry-After: 30s
  • Rajoitukset: 600 pyyntöä/min

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

Virhetyypit

API-dokumentaation julkaisema täydellinen luettelo.

400invalid_request_error
The request is malformed or contains invalid parameters.
401authentication_error
The API key is missing, invalid, or expired.
402insufficient_credits_error
Your account does not have enough credits.
404not_found_error
The requested resource does not exist.
409conflict_error
The request conflicts with current state — e.g. your concurrent-batch cap is reached.
429rate_limit_error
Too many requests. Slow down and retry.Retry-After: 30
500api_error
An internal server error occurred. Retry later.

Virheen rakenne

Sama kehys jokaisessa endpointissa riippumatta siitä, mikä meni pieleen.

{
  "error": {
    "type": "rate_limit_error",
    "message": "Rate limit exceeded."
  },
  "request_id": "req_xxxxxxxx"
}

Virheiden käsittely

  • Noudata Retry-After-arvoa

    Statuskoodi 429 sisältää Retry-After-otsakkeen. Odota ilmoitettu määrä sekunteja ja yritä sitten uudelleen eksponentiaalisella peruutuksella — välitön uudelleenyritys vain siirtää seuraavaa aikaikkunaa kauemmas.

  • Virheet palauttavat credits-yksiköt

    Hyväksymisen jälkeen epäonnistunut generointi palauttaa sen credits-yksiköt automaattisesti, joten uudelleenyritys ei veloita kahdesti.

  • Ilmoita request id

    Jokainen vastaus sisältää tunnisteen `request_id`. Kirjaa se lokiin. Se on tuelle nopein tapa löytää tietty epäonnistuminen tuhansien joukosta.

  • 409 on jonotussignaali

    Konflikti tarkoittaa, että tilauksesi rinnakkaisten erien enimmäismäärä on saavutettu. Pollaa jo käynnissä olevaa erää, kunnes se valmistuu, ja lähetä pyyntö sitten uudelleen — älä tee turhaa pollaussilmukkaa.

Kysymyksiä API-virheistä

Miltä virheen runko näyttää?

`error`-objekti, jossa on `type` ja `message`, sekä `request_id`. Tyyppi on pysyvä ja koneluettava; viesti on tarkoitettu ihmisille ja se voi muuttua.

Mitä virheitä kannattaa yrittää uudelleen?

Statuskoodia 429 Retry-After-sekuntien odottamisen jälkeen sekä 5xx-virheitä eksponentiaalisella peruutuksella. Koodit 400, 401 tai 402 epäonnistuvat samalla tavalla, kunnes jokin muuttuu sinun puolellasi.

Mitä 402 tarkoittaa?

`insufficient_credits_error` — tilillä ei ole tarpeeksi credits-yksiköitä kutsua varten tai koko erän varausta varten. Mitään ei generoida eikä mitään veloiteta.

Miten ilmoitan virheestä?

Lähetä `request_id`, endpoint ja kellonaika. Tämä kolmikko yksilöi tarkan kutsun; itse kuvaa ei tarvita sen hakemiseen.

Endpointit ja viitteet

Jokainen luku tällä sivulla on peräisin Photta-rajapinnan dokumentaatiosta · tarkistettu

Kokeile APIa viidessä minuutissa

Luo Photta-API-avain, liitä yllä oleva cURL-koodinpätkä, ja sinulla on ensimmäinen mallikuva ennen kuin kahvi ehtii tippua.

Luo tili ja hanki API-avainAPI
  • 7 virhetyyppiä
  • Retry-After: 30s
  • 600 pyyntöä/min