Errori

Gli errori compaiono in due punti distinti e usano due vocabolari diversi:

Errori delle richieste API — la risposta HTTP a una chiamata API sincrona (autenticazione, fatturazione, richieste malformate, risorse inesistenti). Vedi Errori delle richieste API.
Codici di fallimento delle prediction — la richiesta è stata accettata e messa in coda, ma la prediction stessa si è conclusa con status: "failed". Il fallimento è descritto dall’oggetto error della prediction, che ottieni dagli endpoint di stato della prediction, dalle consegne webhook e dall’endpoint di risultato. Vedi Codici di fallimento delle prediction.

Codici di fallimento delle prediction

Una prediction fallita porta con sé un oggetto error:

{
  "status": "failed",
  "error": {
    "code": "internal_server_error",
    "reason": "provider_account_error",
    "retryable": false,
    "message": "This model is temporarily unavailable due to an upstream account issue on our side. Retrying will not help; we have been alerted."
  }
}

Campo	Tipo	Descrizione
`code`	string	Classificazione grossolana: in sostanza, di chi è il problema. Sempre presente. Insieme aperto — vedi Valori sconosciuti.
`reason`	string, opzionale	Causa specifica, leggibile dalla macchina. Insieme aperto. Assente quando il fallimento non è stato ricondotto a una causa precisa; l’assenza di per sé non è un segnale.
`retryable`	boolean, opzionale	Indica se riprovare lo stesso input invariato può avere successo. Quando è presente fa fede e prevale su qualsiasi default per `code`.
`message`	string	Spiegazione leggibile da una persona, per i log e per gli utenti finali. La formulazione cambia senza preavviso: non fare mai parsing né confronti su questo testo.
`timestamp`	string, opzionale	Istante ISO 8601 in cui è fallita la prediction — non l’istante della risposta che lo trasporta. Assente per un fallimento che non ha registrato alcun istante di fine.

Le prediction fallite non vengono addebitate; i crediti riservati per la richiesta vengono rilasciati. Una prediction che non è fallita porta con sé error: null. Vedi la Nota di migrazione se hai integrato prima del 17 agosto 2026.

Dove ti arriva l’errore

Lo stesso oggetto error viene pubblicato su ogni canale, così puoi leggerlo dove già guardi:

Canale	Dove si trova l’oggetto
`GET /v1/queue/requests/{request_id}/status` e `/status/stream`	`error`, accanto a `success: false`
`GET /v1/queue/requests/{request_id}` (l’endpoint di risultato)	`error.details` di un `400` — vedi sotto
`GET /v1/predictions/{prediction_id}`	`error`
Consegna webhook	`error` del payload `failed`

Leggere un fallimento dall’endpoint di risultato

Chiedere l’output di una prediction fallita restituisce un 400 con il fallimento che l’ha causato, sotto il codice a livello di richiesta PREDICTION_FAILED:

{
  "error": {
    "type": "invalid_request_error",
    "code": "PREDICTION_FAILED",
    "message": "The prediction may contain sensitive or restricted content and has been suppressed. Please revise your input.",
    "details": {
      "code": "unsafe_content",
      "message": "The prediction may contain sensitive or restricted content and has been suppressed. Please revise your input.",
      "reason": "moderation_blocked",
      "retryable": false,
      "timestamp": "2026-08-14T17:51:47.206Z"
    }
  },
  "request_id": "req_01JXQ2ZK8W3P5N7V0T6Y4M9DQR",
  "timestamp": "2026-08-17T09:00:00.000Z",
  "path": "/v1/queue/requests/pd_a839exsaLNmVZzWvDaxAuapS"
}

Due codici, su due livelli, e non appartengono allo stesso vocabolario:

error.code vale PREDICTION_FAILED, un errore di richiesta API che significa «la prediction di cui hai chiesto l’output non ne ha prodotto alcuno»;
error.details è l’oggetto error della prediction stessa — identico a quanto /status riporta per la stessa richiesta, così i due endpoint non possono mai essere in disaccordo sul motivo del fallimento. Fai i tuoi rami su error.details.reason e error.details.retryable.

error.message ripete il messaggio della prediction, così anche un client che legge soltanto il messaggio di primo livello ottiene comunque qualcosa di utile. Due timestamp, due significati. Il timestamp di primo livello indica quando è stata prodotta questa risposta HTTP; error.details.timestamp indica quando è fallita la prediction. Per una prediction che recuperi giorni dopo, i due distano giorni. Leggi quello interno ogni volta che intendi il fallimento. Le librerie client ufficiali fanno questo lavoro per te: result() solleva un errore i cui code, reason e retryable sono quelli della prediction stessa, identici a quelli che subscribe() solleva per lo stesso fallimento. Una prediction ancora in coda o in esecuzione, oppure annullata, continua a restituire lo stesso 400 generico di sempre.

Decidere se riprovare

Leggi retryable. Risponde esattamente a una domanda — inviare di nuovo questa identica richiesta porterà a un esito diverso? — ed è indipendente da code: lo stesso code può essere ritentabile in un fallimento e non in un altro. retryable è opzionale. Quando è assente, ricadi sul default per code indicato nella tabella qui sotto. È il comportamento che Sunra aveva prima che questo campo esistesse, quindi ricadere sul default è sempre sicuro: semplicemente è meno preciso.

`code`

Codice	Default quando `retryable` è assente	Significato
`invalid_input`	No — correggi prima l’input	L’input è stato rifiutato, dalla validazione dello schema oppure dal provider del modello (ad es. testo oltre il limite di lunghezza, un’immagine non decodificabile, una combinazione di parametri non valida), oppure non è stato possibile scaricare un file di input. Il `message` indica il problema specifico.
`unsafe_content`	No — modifica prima il contenuto	Il prompt o il media in input è stato bloccato dal sistema di sicurezza del provider del modello, oppure l’output generato è stato soppresso dallo stesso. Riprovare con lo stesso contenuto verrà bloccato di nuovo: modifica il prompt o il media.
`service_provider_error`	Sì — può essere transitorio	Il provider del modello a monte non è riuscito a servire la richiesta (disservizio del provider, rate limiting). Riprovare più tardi, o con un modello diverso, può funzionare.
`internal_server_error`	Sì	Un guasto lato Sunra. Alcuni sono transitori e vale la pena riprovare; altri (un endpoint mal configurato, un problema con il nostro account a monte) no, e questi portano `retryable: false`.
`task_timeout`	Sì	La prediction non è terminata entro il tempo consentito. Riprovare può funzionare, soprattutto quando il carico è più basso.

`reason`

reason nomina la causa specifica dietro a code. Usalo per metriche, instradamento e diagnosi del supporto; per la decisione se riprovare usa retryable. Ogni reason pubblicata a oggi ha una sezione dedicata qui sotto, e la sua àncora è la reason stessa — #input_fetch_failed, #moderation_blocked e così via — così una segnalazione di errore può rimandare direttamente al suo significato.

Reason	`code`	`retryable`
`input_validation_failed`	`invalid_input`	`false`
`provider_rejected_input`	`invalid_input`	`false`
`input_fetch_failed`	`invalid_input`	`false` o `true`
`moderation_blocked`	`unsafe_content`	`false`
`provider_rate_limited`	`service_provider_error`	`true`
`provider_unavailable`	`service_provider_error`	`true`
`provider_timeout`	`task_timeout`	`true`
`provider_account_error`	`internal_server_error`	`false`
`endpoint_misconfigured`	`internal_server_error`	`false`
`queue_enqueue_failed`	`internal_server_error`	`true`
`reaped_stalled`	`internal_server_error`	`true`

`input_validation_failed`

code: invalid_input · retryable: false La richiesta non ha superato la validazione di schema o di parametri di Sunra. Il message indica il campo che ha causato l’errore. Cosa fare: correggi il campo indicato. La stessa richiesta continuerà a fallire.

`provider_rejected_input`

code: invalid_input · retryable: false Il provider del modello ha rifiutato uno o più parametri di input. Quando il provider ci dice quali, il message lo riporta; alcuni provider comunicano soltanto che l’input non era accettabile, e in quel caso lo diciamo esattamente così invece di tirare a indovinare. Cosa fare: confronta i tuoi parametri con lo schema del modello — un valore fuori intervallo, una combinazione non supportata, un rapporto d’aspetto o una durata che il modello non accetta.

`input_fetch_failed`

code: invalid_input · retryable: false o true Non è stato possibile scaricare un file di input indicato tramite URL. È l’unica reason il cui retryable varia davvero, quindi leggi il campo invece di darlo per scontato:

false — l’host ci ha respinti: un 4xx, un indirizzo da cui non ci è consentito scaricare, un redirect o un file oltre il limite di dimensione;
true — l’host è risultato momentaneamente irraggiungibile: un 5xx, un timeout o un errore DNS.

Il message riporta l’URL che hai inviato, così puoi capire quale input non è stato scaricato — privato della query string, in modo che le credenziali contenute in un presigned URL non ti vengano mai restituite:

{
  "code": "invalid_input",
  "reason": "input_fetch_failed",
  "retryable": false,
  "message": "Failed to fetch the input file at https://media.example.com/uploads/reference.png: HTTP 403."
}

Cosa fare: quando retryable è false, verifica che l’URL sia raggiungibile pubblicamente e che un link presigned non sia scaduto. Quando è true, riprova.

`moderation_blocked`

code: unsafe_content · retryable: false Bloccato dal sistema di content safety del provider del modello — sia il prompt e i media in ingresso, sia l’output generato in uscita. Cosa fare: cambia il prompt o i media. Reinviare lo stesso contenuto verrà bloccato di nuovo.

`provider_rate_limited`

code: service_provider_error · retryable: true Il provider del modello sta applicando rate limiting alle richieste. Cosa fare: riprova con backoff, oppure instrada su un altro modello.

`provider_unavailable`

code: service_provider_error · retryable: true Il provider del modello non è riuscito a servire la richiesta. Cosa fare: riprova più tardi, oppure instrada su un altro modello.

`provider_timeout`

code: task_timeout · retryable: true La prediction non è stata completata entro il tempo consentito. Cosa fare: riprova — un momento di carico più basso, o una richiesta più piccola (durata più breve, risoluzione più bassa), aumenta le probabilità.

`provider_account_error`

code: internal_server_error · retryable: false Il nostro account presso il provider del modello ha un problema — fatturazione, credenziali o una quota permanente. La colpa è nostra, non del tuo input. Cosa fare: nulla dalla tua parte; riprovare non serve e riceviamo un alert in automatico. Instrada su un altro modello se ti serve subito quella capacità.

`endpoint_misconfigured`

code: internal_server_error · retryable: false Questo endpoint del modello è mal configurato dalla nostra parte. Cosa fare: nulla dalla tua parte; riprovare non serve e riceviamo un alert in automatico. Se è urgente contatta il supporto indicando il request_id.

`queue_enqueue_failed`

code: internal_server_error · retryable: true Non è stato possibile mettere la prediction in coda. Cosa fare: rinvia la richiesta.

`reaped_stalled`

code: internal_server_error · retryable: true La prediction si è bloccata ed è stata terminata. Cosa fare: rinvia la richiesta.

Valori sconosciuti

Sia code sia reason sono insiemi aperti. Nuovi valori vengono aggiunti man mano che classifichiamo altri fallimenti, senza annunci di breaking change. La tua integrazione non deve andare in crash, scartare l’errore o rifiutare il payload quando incontra un valore che non riconosce.

reason sconosciuto — trattalo come se reason fosse assente e decidi in base a retryable (o al default per code). Conserva il valore grezzo nei log: è il modo più rapido per far identificare il fallimento al supporto.
code sconosciuto — trattalo come internal_server_error. C’è un valore sentinella che vale la pena conoscere per nome: unknown_error_code, che Sunra emette quando una prediction è fallita ma non è stato possibile recuperarne alcuna classificazione.

Nota di migrazione: error è null quando non c’è alcun errore

In vigore dal 17 agosto 2026. L’oggetto error ha un’unica rappresentazione su ogni canale. Tre differenze tra loro sono sparite:

error vale null quando la prediction non è fallita. GET /v1/predictions/{prediction_id} rispondeva con un oggetto vuoto — "error": {} — su ogni prediction riuscita, in coda o annullata. Ora risponde "error": null, che è ciò che l’endpoint di stato della coda faceva già. Se verifichi che sia vuoto (Object.keys(response.error).length === 0), sostituisci quel controllo con un controllo su null (response.error === null).
Un fallimento porta sempre con sé un code e un message non vuoti. Dove un fallimento ha registrato qualcosa che non siamo in grado di classificare, ora ricevi il valore sentinella unknown_error_code e un messaggio generico, invece di un campo mancante, vuoto o che non è una stringa.
I fallimenti registrati come testo semplice ti arrivano come testo. Poche prediction dell’aprile 2026 hanno memorizzato il proprio errore come stringa nuda. GET /v1/predictions/{prediction_id} la scartava e l’endpoint di stato della coda la sostituiva con il messaggio sentinella; ora entrambi la pubblicano come message sotto code: "unknown_error_code".

Non è stato rimosso nulla e non è comparso alcun campo nuovo: error era già presente su ognuna di queste risposte, ed è cambiato soltanto il suo valore. Le consegne webhook non sono state toccate — erano già la forma su cui gli altri canali sono convergiti — e error resta assente da una consegna succeeded invece di essere inviato come null. Finestra di compatibilità. Non c’è alcun periodo di doppia emissione: da quella data l’API ha smesso di produrre "error": {}. Se riesegui o rielabori payload catturati prima di allora, tratta null e {} come la stessa cosa finché quei dati memorizzati non saranno scaduti.

Modifica in arrivo: alcuni fallimenti riceveranno un `code` più specifico

Oggi una quota rilevante dei fallimenti viene segnalata come service_provider_error, inclusi molti che non sono né transitori né colpa del provider. Man mano che classifichiamo i provider uno alla volta, quei fallimenti passano al code che li descrive davvero:

un provider che rifiuta in modo deterministico il tuo input diventa invalid_input (prima service_provider_error);
un problema lato Sunra, come un endpoint mal configurato o il nostro account presso il provider, diventa internal_server_error (prima service_provider_error);
un file di input che non siamo riusciti a scaricare diventa invalid_input (prima internal_server_error).

Nessun codice viene rinominato o rimosso e non viene introdotto alcun nuovo valore di code: i cinque valori qui sopra restano l’insieme completo dei codici classificati. Ciò che cambia è quale di essi viene assegnato a un dato fallimento, e cambia gradualmente, provider per provider. Se il tuo codice si dirama su code, questo è il momento giusto per spostare quella logica su retryable e reason, che descrivono il fallimento in modo diretto e non sono toccati da questa riclassificazione.

Errori delle richieste API

Tipo di errore	Codice di errore	Stato HTTP	Descrizione
authentication_error	`INVALID_CREDENTIALS`	401	Il nome utente o la password forniti non sono corretti
authentication_error	`TOKEN_EXPIRED`	401	Il token di autenticazione è scaduto e deve essere rinnovato
authorization_error	`ACCOUNT_NOT_ACTIVE`	403	L’account utente è inattivo o sospeso
authorization_error	`API_KEY_INACTIVE`	403	La chiave API è disabilitata o sospesa
authorization_error	`FROZEN_CREDIT_OPERATION_NOT_ALLOWED`	403	Impossibile eseguire operazioni su crediti congelati in questo stato
authorization_error	`INSUFFICIENT_PERMISSION`	403	L’utente non dispone delle autorizzazioni necessarie per questa operazione
authorization_error	`MODEL_ACCESS_DENIED`	403	L’accesso al modello richiesto non è consentito per questo utente
authorization_error	`PREDICTION_ACCESS_DENIED`	403	L’accesso alla previsione richiesta non è consentito per questo utente
authorization_error	`PRICING_OPERATION_NOT_ALLOWED`	403	L’operazione di determinazione del prezzo non è consentita nel contesto corrente
client_error	`PAYMENT_PROCESSING_ERROR`	402	Impossibile elaborare il pagamento a causa di problemi con il metodo di pagamento
client_error	`PREDICTION_CREDITS_ERROR`	402	Crediti insufficienti da riservare per la richiesta di previsione
conflict_error	`CREDIT_PACKAGE_UNAVAILABLE`	409	Il pacchetto di crediti non è disponibile per l’acquisto
conflict_error	`DUPLICATE_API_KEY_NAME`	409	Esiste già una chiave API con questo nome nell’organizzazione
conflict_error	`DUPLICATE_INVITATION`	409	Esiste già un invito attivo per questo utente
conflict_error	`INVALID_FROZEN_CREDIT_STATUS`	409	Il credito congelato non si trova nello stato previsto per questa operazione
conflict_error	`INVALID_PAYMENT_STATUS`	409	Il pagamento non si trova nello stato corretto per questa operazione
conflict_error	`INVALID_SUBSCRIPTION_STATUS_TRANSITION`	409	Impossibile modificare l’abbonamento dallo stato corrente allo stato richiesto
conflict_error	`MODEL_ENDPOINT_ALREADY_EXISTS`	409	Esiste già un endpoint del modello con questa configurazione
conflict_error	`PAYMENT_ALREADY_PROCESSED`	409	Il pagamento è già stato elaborato e non può essere modificato
conflict_error	`PREDICTION_CANNOT_BE_CANCELED`	409	La previsione si trova in uno stato che non può essere annullato
conflict_error	`PREDICTION_INVALID_STATUS`	409	La previsione non si trova nello stato previsto per questa operazione
conflict_error	`PREDICTION_STALLED`	409	La previsione è in stallo da troppo tempo e richiede attenzione
conflict_error	`QUEUE_ITEM_CANNOT_BE_CANCELED`	409	La previsione in coda non può essere annullata nel suo stato corrente
conflict_error	`SERVICE_PROVIDER_ALREADY_EXISTS`	409	Esiste già un fornitore di servizi con questo nome
conflict_error	`TRANSACTION_ALREADY_VOIDED`	409	La transazione è già stata annullata
conflict_error	`TRANSACTION_NOT_VOIDED`	409	La transazione non si trova in uno stato annullato
gone_error	`CREDIT_EXPIRED`	410	Il bucket di crediti è scaduto e non è più disponibile
gone_error	`INVITATION_EXPIRED`	410	L’invito è scaduto e non è più valido
invalid_request_error	`CHECKOUT_SESSION_CREATION_ERROR`	400	Impossibile creare la sessione di pagamento
invalid_request_error	`CODE_VERIFICATION_FAILED`	400	Il codice di verifica non è valido o è scaduto
invalid_request_error	`CREDIT_AMOUNT_VALIDATION_ERROR`	400	L’importo del credito fornito non è valido
invalid_request_error	`CURRENCY_MISMATCH`	400	La valuta non corrisponde alla valuta prevista
invalid_request_error	`FREEZE_AMOUNT_NOT_SET`	400	La configurazione dei prezzi è richiesta prima di effettuare previsioni
invalid_request_error	`HIGH_PRECISION_DECIMAL_VALIDATION_ERROR`	400	Il valore decimale fornito non è valido o ha troppe cifre decimali
invalid_request_error	`INIT_PAYLOAD_QUEUE_NAME_MISSING`	400	Il nome della coda è richiesto nel payload di inizializzazione
invalid_request_error	`INVALID_CREDIT_AMOUNT`	400	L’importo del credito specificato non è valido
invalid_request_error	`INVALID_PAYMENT_AMOUNT`	400	L’importo del pagamento non è valido
invalid_request_error	`INVALID_PAYMENT_METHOD`	400	Il metodo di pagamento fornito non è valido
invalid_request_error	`INVALID_SUBSCRIPTION_DATA`	400	I dati dell’abbonamento forniti contengono informazioni non valide
invalid_request_error	`INVALID_SUBSCRIPTION_OPERATION`	400	L’operazione di abbonamento non è valida
invalid_request_error	`INVALID_VOID_METADATA`	400	I metadati di annullamento richiesti sono mancanti o non validi
invalid_request_error	`MISSING_PAYMENT_METHOD`	400	Per questa operazione è richiesto un metodo di pagamento
invalid_request_error	`MODEL_ENDPOINT_PRICE_ITEM_INVALID`	400	La configurazione dei prezzi dell’endpoint del modello non è valida
invalid_request_error	`MODEL_ENDPOINT_PRICE_TYPE_NOT_SUPPORTED`	400	Il tipo di prezzo non è supportato per questo endpoint del modello
invalid_request_error	`PAYMENT_VALIDATION_ERROR`	400	Le informazioni di pagamento non hanno superato la convalida
invalid_request_error	`PREDICTION_INVALID_INPUT`	400	L’input fornito per la previsione non è valido
invalid_request_error	`PREDICTION_FAILED`	400	La prediction di cui hai chiesto l’output si è conclusa con `status: "failed"`. `error.details` contiene il fallimento della prediction.
invalid_request_error	`PRICE_TYPE_INVALID`	400	Il tipo di prezzo specificato non è valido
invalid_request_error	`PRICE_USAGE_KEY_MISSING`	400	Per questo tipo di prezzo è richiesta una chiave di utilizzo
invalid_request_error	`PRICE_USAGE_VALUE_INVALID`	400	Il valore di utilizzo fornito non è valido
invalid_request_error	`PRICING_VALIDATION_ERROR`	400	La configurazione dei prezzi non ha superato la convalida
invalid_request_error	`SUBSCRIPTION_OPERATION_ERROR`	400	L’operazione di abbonamento non è riuscita
not_found_error	`API_KEY_NOT_FOUND`	404	La chiave API specificata non esiste
not_found_error	`CREDIT_BUCKET_NOT_FOUND`	404	Il bucket di crediti specificato non esiste
not_found_error	`CREDIT_PACKAGE_NOT_FOUND`	404	Il pacchetto di crediti specificato non esiste
not_found_error	`CUSTOMER_PROFILE_NOT_FOUND`	404	Impossibile trovare il profilo del cliente
not_found_error	`FROZEN_CREDIT_NOT_FOUND`	404	Impossibile trovare il record di credito congelato
not_found_error	`INVITATION_NOT_FOUND`	404	L’invito specificato non esiste
not_found_error	`MODEL_ENDPOINT_NOT_FOUND`	404	L’endpoint del modello specificato non esiste
not_found_error	`MODEL_ENDPOINT_PRICE_ITEM_NOT_FOUND`	404	La configurazione dei prezzi per questo endpoint del modello non esiste
not_found_error	`MODEL_ENDPOINT_PRICE_NOT_FOUND`	404	Nessun prezzo trovato per l’endpoint del modello specificato
not_found_error	`MODEL_NOT_FOUND`	404	Il modello specificato non esiste
not_found_error	`MODEL_NOT_FOUND`	404	Il modello specificato non esiste
not_found_error	`MODEL_PROVIDER_NOT_FOUND`	404	Il fornitore del modello specificato non esiste
not_found_error	`MODEL_PROVIDER_NOT_FOUND`	404	Il fornitore del modello specificato non esiste
not_found_error	`ORGANIZATION_MEMBER_NOT_FOUND`	404	Il membro dell’organizzazione specificato non esiste
not_found_error	`ORGANIZATION_NOT_FOUND`	404	L’organizzazione specificata non esiste
not_found_error	`PAYMENT_METHOD_NOT_FOUND`	404	Il metodo di pagamento specificato non esiste
not_found_error	`PAYMENT_NOT_FOUND`	404	Il pagamento specificato non esiste
not_found_error	`PREDICTION_NOT_FOUND`	404	La previsione specificata non esiste
not_found_error	`PREDICTION_NOT_FOUND`	404	La previsione specificata non esiste
not_found_error	`PRICE_NOT_FOUND`	404	La configurazione dei prezzi specificata non esiste
not_found_error	`QUEUE_ITEM_NOT_FOUND`	404	L’elemento della coda specificato non esiste
not_found_error	`SERVICE_PROVIDER_NOT_FOUND`	404	Il fornitore di servizi specificato non esiste
not_found_error	`SERVICE_PROVIDER_NOT_FOUND`	404	Il fornitore di servizi specificato non esiste
not_found_error	`SUBSCRIPTION_NOT_FOUND`	404	L’abbonamento specificato non esiste
not_found_error	`TASK_LOG_NOT_FOUND`	404	Il log dell’attività specificato non esiste
not_found_error	`TRANSACTION_NOT_FOUND`	404	La transazione specificata non esiste
not_found_error	`USER_NOT_FOUND`	404	L’utente specificato non esiste
precondition_failed_error	`INSUFFICIENT_CREDIT`	412	Crediti insufficienti disponibili per questa operazione
service_unavailable_error	`PREDICTION_UNAVAILABLE`	503	Il servizio di previsione non è attualmente disponibile
service_unavailable_error	`STRIPE_OPERATION_ERROR`	503	Il servizio di pagamento non è attualmente disponibile
unprocessable_entity_error	`MODEL_ENDPOINT_PRICE_ITEM_MATCH_FAILED`	422	Impossibile trovare un prezzo corrispondente per la configurazione dell’endpoint del modello
unprocessable_entity_error	`PREDICTION_UNSAFE_CONTENT`	422	L’input della previsione contiene contenuti non sicuri o inappropriati
unprocessable_entity_error	`PRICE_CALCULATION_ERROR`	422	Impossibile calcolare il prezzo per la configurazione richiesta

Panoramica

Multimodal

LLM

Librerie client

Codici di fallimento delle prediction

Dove ti arriva l’errore

Leggere un fallimento dall’endpoint di risultato

Decidere se riprovare

`code`

`reason`

`input_validation_failed`

`provider_rejected_input`

`input_fetch_failed`

`moderation_blocked`

`provider_rate_limited`

`provider_unavailable`

`provider_timeout`

`provider_account_error`

`endpoint_misconfigured`

`queue_enqueue_failed`

`reaped_stalled`

Valori sconosciuti

Nota di migrazione: error è null quando non c’è alcun errore

Modifica in arrivo: alcuni fallimenti riceveranno un `code` più specifico

Errori delle richieste API

​Codici di fallimento delle prediction

​Dove ti arriva l’errore

​Leggere un fallimento dall’endpoint di risultato

​Decidere se riprovare

​code

​reason

​input_validation_failed

​provider_rejected_input

​input_fetch_failed

​moderation_blocked

​provider_rate_limited

​provider_unavailable

​provider_timeout

​provider_account_error

​endpoint_misconfigured

​queue_enqueue_failed

​reaped_stalled

​Valori sconosciuti

​Nota di migrazione: error è null quando non c’è alcun errore

​Modifica in arrivo: alcuni fallimenti riceveranno un code più specifico

​Errori delle richieste API

Codici di fallimento delle prediction

Dove ti arriva l’errore

Leggere un fallimento dall’endpoint di risultato

Decidere se riprovare

`code`

`reason`

`input_validation_failed`

`provider_rejected_input`

`input_fetch_failed`

`moderation_blocked`

`provider_rate_limited`

`provider_unavailable`

`provider_timeout`

`provider_account_error`

`endpoint_misconfigured`

`queue_enqueue_failed`

`reaped_stalled`

Valori sconosciuti

Nota di migrazione: error è null quando non c’è alcun errore

Modifica in arrivo: alcuni fallimenti riceveranno un `code` più specifico

Errori delle richieste API