Errori

L'API VIDIO utilizza un formato di oggetto errore coerente. Usa questa pagina per comprendere i tipi di errore comuni, i codici di stato HTTP e i messaggi di esempio restituiti dall'API.

L'accesso all'API è attualmente disponibile solo per i piani Enterprise. Richiedi l'accesso qui se non sei un utente Enterprise ma sei interessato a utilizzare l'API.

Panoramica

Quando una richiesta non riesce, l'API VIDIO restituisce un oggetto errore con un tipo e un messaggio. Alcuni errori possono anche includere campi aggiuntivi per aiutare a spiegare il fallimento.

Formato errore

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Lavoro non trovato"
  }
}

Riferimento errore

Status	Type	Message	Description
400	invalid_request_error	Mancano parametri di query richiesti nella richiesta dell'URL di upload	Restituito quando mancano i parametri di query richiesti dalla richiesta dell'URL di upload.
400	invalid_request_error	Mancante job_id	Restituito quando la richiesta di rendering non include un ID lavoro.
400	invalid_request_error	Nessun output disponibile per questo lavoro	Restituito quando il lavoro non ha output renderizzabili.
400	invalid_request_error	input_keys deve essere un array non vuoto	Restituito quando `input_keys` è mancante o vuoto.
400	invalid_request_error	input_keys deve contenere almeno una chiave di input valida	Restituito quando tutte le chiavi di input fornite sono vuote o non valide dopo la normalizzazione.
400	invalid_request_error	Categoria video non valida. Valori consentiti: podcast, sport con palla, sport senza palla, demo prodotto di bellezza, matrimonio, viaggio, altri	Restituito quando `video_category` non è supportato.
400	invalid_request_error	aspect_ratio non valido. Valori consentiti: quadrato, ritratto, paesaggio	Restituito quando `aspect_ratio` non è supportato.
400	invalid_request_error	output_length deve essere un numero positivo	Restituito quando `output_length` è mancante, zero o negativo.
400	invalid_request_error	Impossibile determinare la durata di input positiva dai metadati di input_keys	Restituito quando l'API non riesce a determinare una durata valida per gli input caricati.
401	authentication_error	Manca la chiave API	Restituito quando l'intestazione `x-api-key` non è fornita.
401	authentication_error	Chiave API non valida	Restituito quando la chiave API fornita non corrisponde a una chiave attiva.
402	insufficient_balance	Non hai abbastanza crediti per elaborare questo lavoro	Restituito quando l'account non ha abbastanza crediti per l'elaborazione o il rendering.
403	permission_error	Non hai il permesso di accedere a questo lavoro	Restituito quando l'utente autenticato non possiede il lavoro richiesto.
403	permission_error	Non hai il permesso di renderizzare questo lavoro	Restituito quando l'utente autenticato non possiede il lavoro in fase di rendering.
404	invalid_request_error	Lavoro non trovato	Restituito quando il lavoro richiesto non esiste.
404	invalid_request_error	Utente non trovato	Restituito quando il record dell'utente autenticato non può essere trovato.
429	rate_limit_error	Troppe richieste	Restituito quando il client supera il tasso di richiesta consentito per l'endpoint. Il limite attuale è di 60 richieste al minuto. Il throttling è principalmente applicato per chiave API utilizzando l'intestazione x-api-key e torna all'indirizzo IP del client quando non è presente una chiave API. I client che raggiungono questo limite dovrebbero ridurre la frequenza delle richieste e riprovare dopo il ripristino della finestra di limite.
500	api_error	Errore di autenticazione	Restituito quando l'autenticazione con chiave API fallisce inaspettatamente sul server.
500	api_error	Errore interno del server	Restituito per errori imprevisti lato server negli endpoint di stato, rendering o highlight reel.
500	server_error	Impossibile generare l'URL di upload	Restituito quando il server non riesce a generare un'URL di upload firmato.