Greške
VIDIO API koristi dosledan format objekta greške. Koristite ovu stranicu da biste razumeli uobičajene tipove grešaka, HTTP statusne kodove i primer poruka koje vraća API.
API pristup je trenutno dostupan za Studio plan i iznad.
Pregled
Kada zahtev ne uspe, VIDIO API vraća objekat greška sa tip i poruka. Neke greške mogu takođe uključivati dodatna polja koja pomažu u objašnjavanju neuspeha.
Format greške
json
{
"error": {
"type": "invalid_request_error",
"message": "Posao nije pronađen"
}
}Referenca grešaka
| Status | Type | Message | Description |
|---|---|---|---|
| 400 | invalid_request_error | Nedostaju obavezni parametri upita u zahtevu za URL za otpremanje | Vraćeno kada u zahtevu za URL za otpremanje nedostaju obavezni parametri upita. |
| 400 | invalid_request_error | Nedostaje job_id | Vraćeno kada zahtev za renderovanje ne sadrži job_id. |
| 400 | invalid_request_error | Nema dostupnih izlaza za ovaj posao | Vraćeno kada posao nema izlaze koji se mogu renderovati. |
| 400 | invalid_request_error | input_keys mora biti neprazan niz | Vraćeno kada `input_keys` nedostaje ili je prazan. |
| 400 | invalid_request_error | input_keys mora sadržati najmanje jedan važeći ključ ulaza | Vraćeno kada su svi navedeni ključevi ulaza prazni ili nevažeći nakon normalizacije. |
| 400 | input_duration_requirement_error | Ukupno trajanje ulaza mora biti duže od 2 sekunde | Vraćeno kada je zbirno trajanje svih ulaznih medija 2 sekunde ili manje. |
| 400 | input_duration_requirement_error | Ukupno trajanje ulaza mora biti manje od 6 sati | Vraćeno kada je zbirno trajanje svih ulaznih medija 6 sati ili više. |
| 400 | input_image_count_requirement_error | Broj ulaznih slika ne sme biti veći od 4000 | Vraćeno kada broj ulaznih slika premašuje maksimalno dozvoljeni limit od 4000. |
| 400 | input_video_count_requirement_error | Broj ulaznih video zapisa ne sme biti veći od 400 | Vraćeno kada broj ulaznih video zapisa premašuje maksimalno dozvoljeni limit od 400. |
| 400 | invalid_request_error | Nevažeća vrednost video_category. Dozvoljene vrednosti: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others | Vraćeno kada `video_category` nije podržan. |
| 400 | invalid_request_error | Nevažeća vrednost aspect_ratio. Dozvoljene vrednosti: square, portrait, landscape | Vraćeno kada `aspect_ratio` nije podržan. |
| 400 | invalid_request_error | output_length mora biti pozitivan broj | Vraćeno kada `output_length` nedostaje, je nula ili negativan. |
| 400 | invalid_request_error | Nije moguće odrediti pozitivno trajanje ulaza iz metapodataka input_keys | Vraćeno kada API ne može da odredi važeće trajanje za otpremljene ulaze. |
| 400 | invalid_request_error | music_volume mora biti broj između 0 i 100 | Vraćeno kada je `music_volume` prosleđen, ali nije važeći broj između 0 i 100. |
| 400 | invalid_request_error | original_audio_volume mora biti broj između 0 i 100 | Vraćeno kada je `original_audio_volume` prosleđen, ali nije važeći broj između 0 i 100. |
| 400 | invalid_request_error | Nevažeća vrednost music_category. Dozvoljene vrednosti: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs | Vraćeno kada je `music_category` prosleđen, ali ne odgovara nijednoj od podržanih muzičkih kategorija. |
| 401 | authentication_error | Nedostaje API ključ | Vraćeno kada zaglavlje `x-api-key` nije prosleđeno. |
| 401 | authentication_error | Nevažeći API ključ | Vraćeno kada prosleđeni API ključ ne odgovara aktivnom ključu. |
| 402 | insufficient_balance | Nemate dovoljno kredita za obradu ovog posla | Vraćeno kada nalog nema dovoljno kredita za obradu ili renderovanje. |
| 403 | permission_error | Nemate dozvolu za pristup ovom poslu | Vraćeno kada ulogovani korisnik nije vlasnik traženog posla. |
| 403 | permission_error | Nemate dozvolu za renderovanje ovog posla | Vraćeno kada ulogovani korisnik nije vlasnik posla koji se renderuje. |
| 404 | invalid_request_error | Posao nije pronađen | Vraćeno kada traženi posao ne postoji. |
| 404 | invalid_request_error | Korisnik nije pronađen | Vraćeno kada zapis o ulogovanom korisniku ne može da se pronađe. |
| 429 | rate_limit_error | Previše zahteva | Vraćeno kada klijent prekorači dozvoljenu stopu zahteva za ovaj endpoint. Trenutni limit je 60 zahteva po minuti. Ograničavanje stope zahteva primenjuje se prvenstveno po API ključu koristeći zaglavlje x-api-key, a kada API ključ nije prisutan prelazi se na IP adresu klijenta. Klijenti koji dostignu ovaj limit treba da smanje učestalost zahteva i pokušaju ponovo nakon što se vremenski prozor za limit resetuje. |
| 429 | rate_limit_error | Već imate 10 aktivnih ili u redu čekanja poslova, što je maksimalno dozvoljeno. Sačekajte da se neki poslovi završe pre nego što pošaljete novi. | Vraćeno kada korisnik već ima maksimalan dozvoljeni broj poslova u toku, kako onih koji se izvršavaju na serverima, tako i onih koji čekaju u redu. Trenutni limit je ukupno 10 aktivnih ili u redu čekanja poslova po korisniku. Vlasništvo se utvrđuje povezivanjem svakog job_id na zauzetim serverima i unosima u čekanju sa user_email korisnika. Klijenti koji dostignu ovaj limit treba da sačekaju da se jedan ili više postojećih poslova završe pre nego što kreiraju ili renderuju novi posao. |
| 500 | api_error | Greška pri autentifikaciji | Vraćeno kada autentifikacija API ključa neočekivano zakaže na serveru. |
| 500 | api_error | Interna greška servera | Vraćeno za neočekivane greške na serverskoj strani u endpoint-ima za status, renderovanje ili highlight reel. |
| 500 | server_error | Neuspešno generisanje URL-a za otpremanje | Vraćeno kada server ne uspe da generiše potpisani URL za otpremanje. |