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 per il piano Studio e superiore.

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	Parametri di query richiesti mancanti nella richiesta dell'URL di upload	Restituito quando mancano i parametri di query richiesti nella richiesta dell'URL di upload.
400	invalid_request_error	job_id mancante	Restituito quando la richiesta di rendering non include un job ID.
400	invalid_request_error	Nessun output disponibile per questo job	Restituito quando il job non ha output renderizzabili.
400	invalid_request_error	input_keys deve essere un array non vuoto	Restituito quando `input_keys` è assente 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	input_duration_requirement_error	La durata totale degli input deve essere superiore a 2 secondi	Restituito quando la durata combinata di tutti i media in input è di 2 secondi o meno.
400	input_duration_requirement_error	La durata totale degli input deve essere inferiore a 6 ore	Restituito quando la durata combinata di tutti i media in input è di 6 ore o più.
400	input_image_count_requirement_error	Il numero di immagini di input non può superare 4000	Restituito quando il numero di immagini di input supera il limite massimo consentito di 4000.
400	input_video_count_requirement_error	Il numero di video di input non può superare 400	Restituito quando il numero di video di input supera il limite massimo consentito di 400.
400	invalid_request_error	video_category non valido. Valori consentiti: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Restituito quando `video_category` non è supportato.
400	invalid_request_error	aspect_ratio non valido. Valori consentiti: square, portrait, landscape	Restituito quando `aspect_ratio` non è supportato.
400	invalid_request_error	output_length deve essere un numero positivo	Restituito quando `output_length` è assente, zero o negativo.
400	invalid_request_error	Impossibile determinare una durata positiva degli input dai metadati di input_keys	Restituito quando l'API non riesce a determinare una durata valida per gli input caricati.
400	invalid_request_error	music_volume deve essere un numero compreso tra 0 e 100	Restituito quando `music_volume` è fornito ma non è un numero valido compreso tra 0 e 100.
400	invalid_request_error	original_audio_volume deve essere un numero compreso tra 0 e 100	Restituito quando `original_audio_volume` è fornito ma non è un numero valido compreso tra 0 e 100.
400	invalid_request_error	music_category non valido. Valori consentiti: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Restituito quando `music_category` è fornito ma non corrisponde a una delle categorie musicali supportate.
401	authentication_error	Chiave API mancante	Restituito quando l'header `x-api-key` non è fornito.
401	authentication_error	Chiave API non valida	Restituito quando la chiave API fornita non corrisponde a una chiave attiva.
402	insufficient_balance	Non hai crediti sufficienti per elaborare questo job	Restituito quando l'account non ha crediti sufficienti per l'elaborazione o il rendering.
403	permission_error	Non hai il permesso di accedere a questo job	Restituito quando l'utente autenticato non è proprietario del job richiesto.
403	permission_error	Non hai il permesso di eseguire il rendering di questo job	Restituito quando l'utente autenticato non è proprietario del job che si sta renderizzando.
404	invalid_request_error	Job non trovato	Restituito quando il job 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 richieste consentito per l'endpoint. Il limite attuale è di 60 richieste al minuto. Il rate limiting è applicato principalmente per chiave API utilizzando l'header x-api-key, e ricorre 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 reset della finestra di rate limit.
429	rate_limit_error	Hai già 10 job in esecuzione o in coda, che è il massimo consentito. Attendi che alcuni job terminino prima di inviarne un altro.	Restituito quando l'utente ha già il numero massimo consentito di job in corso, sia tra i job in esecuzione sui server sia tra i job in attesa nella coda. Il limite attuale è di 10 job totali in esecuzione o in coda per utente. La proprietà è determinata confrontando ogni job_id sui server occupati e le voci in coda in sospeso con l'user_email del job. I client che raggiungono questo limite dovrebbero attendere che uno o più job esistenti si completino prima di creare o renderizzare un altro job.
500	api_error	Errore di autenticazione	Restituito quando l'autenticazione della chiave API fallisce inaspettatamente sul server.
500	api_error	Errore interno del server	Restituito per errori inattesi lato server negli endpoint di stato, render 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.