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 API este în prezent disponibil pentru planul Studio și superior.
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 | invalid_request_error | Lipsesc parametrii de interogare obligatorii în cererea pentru URL-ul de încărcare | Returnat când parametrii de interogare necesari lipsesc din cererea pentru URL-ul de încărcare. |
| 400 | invalid_request_error | Missing job_id | Returnat când cererea de redare nu include un ID al jobului. |
| 400 | invalid_request_error | No outputs available for this job | Returnat când jobul nu are niciun rezultat care poate fi redat. |
| 400 | invalid_request_error | input_keys must be a non-empty array | Returnat când `input_keys` lipsește sau este gol. |
| 400 | invalid_request_error | input_keys must contain at least one valid input key | Returnat când toate cheile de input furnizate sunt goale sau invalide după normalizare. |
| 400 | input_duration_requirement_error | Total input duration must be greater than 2 seconds | Returnat când durata combinată a tuturor materialelor de intrare este de 2 secunde sau mai puțin. |
| 400 | input_duration_requirement_error | Total input duration must be less than 6 hours | Returnat când durata combinată a tuturor materialelor de intrare este de 6 ore sau mai mult. |
| 400 | input_image_count_requirement_error | Number of input images must be no more than 4000 | Returnat când numărul de imagini de intrare depășește limita maximă permisă de 4000. |
| 400 | input_video_count_requirement_error | Number of input videos must be no more than 400 | Returnat când numărul de videoclipuri de intrare depășește limita maximă permisă de 400. |
| 400 | invalid_request_error | Valoare invalidă pentru video_category. Valorile permise: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others | Returnat când `video_category` nu este acceptat. |
| 400 | invalid_request_error | Valoare invalidă pentru aspect_ratio. Valorile permise: square, portrait, landscape | Returnat când `aspect_ratio` nu este acceptat. |
| 400 | invalid_request_error | output_length must be a positive number | Returnat când `output_length` lipsește, este zero sau negativ. |
| 400 | invalid_request_error | Could not determine positive input duration from input_keys metadata | Returnat când API-ul nu poate determina o durată validă pentru materialele de intrare încărcate. |
| 400 | invalid_request_error | music_volume must be a number between 0 and 100 | Returnat când `music_volume` este furnizat dar nu este un număr valid între 0 și 100. |
| 400 | invalid_request_error | original_audio_volume must be a number between 0 and 100 | Returnat când `original_audio_volume` este furnizat dar nu este un număr valid între 0 și 100. |
| 400 | invalid_request_error | Valoare invalidă pentru music_category. Valorile permise: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs | Returnat când `music_category` este furnizat dar nu corespunde uneia dintre categoriile muzicale acceptate. |
| 401 | authentication_error | Lipsește cheia API | Returnat când header-ul `x-api-key` nu este furnizat. |
| 401 | authentication_error | Invalid API key | Returnat când cheia API furnizată nu corespunde unei chei active. |
| 402 | insufficient_balance | Nu aveți suficiente credite pentru a procesa acest job | Returnat când contul nu are suficiente credite pentru procesare sau redare. |
| 403 | permission_error | Nu aveți permisiunea de a accesa acest job | Returnat când utilizatorul autentificat nu este proprietarul jobului solicitat. |
| 403 | permission_error | Nu aveți permisiunea de a reda acest job | Returnat când utilizatorul autentificat nu este proprietarul jobului care se redă. |
| 404 | invalid_request_error | Jobul nu a fost găsit | Returnat când jobul solicitat nu există. |
| 404 | invalid_request_error | Utilizatorul nu a fost găsit | Returnat când înregistrarea utilizatorului autentificat nu poate fi găsită. |
| 429 | rate_limit_error | Prea multe cereri | Returnat când clientul depășește rata de cereri permisă pentru endpoint. Limita curentă este de 60 de cereri 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 cererilor și să reîncerce după ce fereastra de limitare a ratei se resetează. |
| 429 | rate_limit_error | You already have 10 running or queued jobs, which is the maximum allowed. Please wait for some jobs to finish before submitting another one. | Returnat când utilizatorul are deja numărul maxim permis de joburi în desfășurare, atât în execuție pe servere, cât și în așteptare în coadă. Limita curentă este de 10 joburi în total (în execuție sau în coadă) pe utilizator. Proprietatea este determinată prin potrivirea fiecărui job_id de pe serverele ocupate și a intrărilor în coadă cu user_email-ul jobului. Clienții care ating această limită ar trebui să aștepte ca unul sau mai multe joburi existente să se încheie înainte de a crea sau reda un alt job. |
| 500 | api_error | Eroare de autentificare | Returnat când autentificarea cheii API eșuează neașteptat pe server. |
| 500 | api_error | Internal server error | Returnat pentru erori neașteptate ale serverului la endpoint-urile status, render sau highlight reel. |
| 500 | server_error | Generarea URL-ului de încărcare a eșuat | Returnat când serverul nu reușește să genereze un URL de încărcare semnat. |