Riferimenti · Errori

Errori delle API di Photta ogni tipo e cosa fare

In sintesi

Ogni fallimento delle API di Photta restituisce la stessa struttura: uno status, un `error.type`, un messaggio e un `request_id`. Riprova i 429 dopo l'header Retry-After e i 5xx con backoff; correggi i 400, 401 e 402 nel tuo codice.

Ottieni una chiave APILeggi la documentazione
  • Errori: 7 tipi di errore
  • Retry-After: Retry-After: 30s
  • Limiti: 600 richieste/min

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato

Tipi di errore

L'elenco completo pubblicato dalla documentazione delle API.

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.

La struttura di un errore

Lo stesso envelope su ogni endpoint, indipendentemente da cosa sia andato storto.

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

Gestione degli errori

  • Rispetta Retry-After

    Un 429 include un header Retry-After. Attendi quel numero di secondi, poi riprova con backoff esponenziale — riprovare subito sposta solo la finestra successiva più avanti.

  • I fallimenti rimborsano i credits

    Una generazione che fallisce dopo essere stata accettata rimborsa automaticamente i propri credits, quindi un retry non comporta un doppio addebito.

  • Indica il request id

    Ogni risposta contiene un `request_id`. Registralo nei log. È il modo più rapido per consentire all'assistenza di individuare uno specifico fallimento tra migliaia.

  • Il 409 è un segnale di coda

    Un conflitto indica che il limite di batch concorrenti del tuo piano è stato raggiunto. Esegui il polling del batch già in corso fino alla sua risoluzione, poi invialo nuovamente — non creare loop a vuoto.

Domande sugli errori delle API

Come si presenta il corpo di un errore?

Un oggetto `error` con un `type` e un `message`, insieme al `request_id`. Il type è stabile e leggibile a livello programmatico; il messaggio è per gli esseri umani e può variare.

Per quali errori vale la pena riprovare?

429 dopo aver atteso i secondi indicati in Retry-After, e 5xx con backoff esponenziale. Un 400, 401 o 402 fallirà allo stesso modo finché non cambia qualcosa dal tuo lato.

Cosa significa un 402?

`insufficient_credits_error` — l'account non ha credits sufficienti per la chiamata, o per l'intera prenotazione in un batch. Nulla viene generato e nulla viene addebitato.

Come si segnala un errore?

Invia il `request_id`, l'endpoint e l'orario. Questa terna identifica la chiamata esatta; l'immagine in sé non è necessaria per individuarla.

Endpoint e riferimenti

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato

Prova l'API in 5 minuti

Genera una chiave API di Photta, incolla lo snippet cURL qui sopra e otterrai la tua prima immagine con modello prima ancora che il caffè sia pronto.

Crea un account e ottieni una chiave APIAPI
  • 7 tipi di errore
  • Retry-After: 30s
  • 600 richieste/min