Erori

API-ul VIDIO folosește un format consistent pentru obiectele de eroare. Folosește această pagină pentru a înțelege tipurile comune de erori, codurile de stare HTTP și mesajele exemplu returnate de API.

Accesul la API este în prezent disponibil doar pentru planurile Enterprise. Solicită acces aici dacă nu ești utilizator Enterprise, dar ești interesat să folosești API-ul.

Prezentare generală

Când o solicitare eșuează, API-ul VIDIO returnează un obiect eroare cu un tip și un mesaj. Unele erori pot include, de asemenea, câmpuri suplimentare pentru a ajuta la explicarea eșecului.

Formatul erorii

json

{
  "eroare": {
    "tip": "eroare_rechiziție_invalidă",
    "mesaj": "Locul de muncă nu a fost găsit"
  }
}

Referință erori

Status	Type	Message	Description
400	eroare_rechiziție_invalidă	Lipsesc parametrii necesari din solicitarea URL-ului de încărcare	Returnat când lipsește parametrii necesari din solicitarea URL-ului de încărcare.
400	eroare_rechiziție_invalidă	Lipsă job_id	Returnat când solicitarea de redare nu include un ID de job.
400	eroare_rechiziție_invalidă	Nu există ieșiri disponibile pentru acest job	Returnat când jobul nu are ieșiri renderizabile.
400	eroare_rechiziție_invalidă	input_keys trebuie să fie un array nenul	Returnat când `input_keys` lipsește sau este gol.
400	eroare_rechiziție_invalidă	input_keys trebuie să conțină cel puțin o cheie de intrare validă	Returnat când toate cheile de intrare furnizate sunt goale sau nevalide după normalizare.
400	eroare_rechiziție_invalidă	video_category invalid. Valori permise: podcast, sport cu mingea, sport fără mingea, demonstrație de produs de frumusețe, nuntă, călătorie, altele	Returnat când `video_category` nu este acceptat.
400	eroare_rechiziție_invalidă	aspect_ratio invalid. Valori permise: pătrat, portret, peisaj	Returnat când `aspect_ratio` nu este acceptat.
400	eroare_rechiziție_invalidă	output_length trebuie să fie un număr pozitiv	Returnat când `output_length` lipsește, este zero sau negativ.
400	eroare_rechiziție_invalidă	Nu s-a putut determina durata pozitivă a intrării din metadatele input_keys	Returnat când API-ul nu poate determina o durată validă pentru intrările încărcate.
401	eroare_autentificare	Lipsă cheie API	Returnat când antetul `x-api-key` nu este furnizat.
401	eroare_autentificare	Cheie API invalidă	Returnat când cheia API furnizată nu se potrivește cu o cheie activă.
402	saldo_insuficient	Nu ai suficiente credite pentru a procesa acest job	Returnat când contul nu are suficiente credite pentru procesare sau redare.
403	eroare_permisie	Nu ai permisiunea de a accesa acest job	Returnat când utilizatorul autentificat nu deține jobul solicitat.
403	eroare_permisie	Nu ai permisiunea de a reda acest job	Returnat când utilizatorul autentificat nu deține jobul care este redat.
404	eroare_rechiziție_invalidă	Jobul nu a fost găsit	Returnat când jobul solicitat nu există.
404	eroare_rechiziție_invalidă	Utilizatorul nu a fost găsit	Returnat când înregistrarea utilizatorului autentificat nu poate fi găsită.
429	eroare_limită_rată	Prea multe solicitări	Returnat când clientul depășește rata de solicitare permisă pentru endpoint. Limita curentă este de 60 de solicitări pe minut. Limitarea ratei se aplică în principal pe baza cheii API folosind antetul x-api-key și revine la adresa IP a clientului atunci când o cheie API nu este prezentă. Clienții care ating această limită ar trebui să reducă frecvența solicitărilor și să reîncerce după ce fereastra de limitare a ratei se resetează.
500	eroare_api	Eroare de autentificare	Returnat când autentificarea cheii API eșuează neașteptat pe server.
500	eroare_api	Eroare internă a serverului	Returnat pentru eșecuri neașteptate ale serverului în endpoint-urile de stare, redare sau compilare.
500	eroare_server	Nu s-a putut genera URL-ul de încărcare	Returnat când serverul nu reușește să genereze un URL de încărcare semnat.