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

StatusTypeMessageDescription
400invalid_request_errorNedostaju obavezni parametri upita u zahtevu za URL za otpremanjeVraćeno kada u zahtevu za URL za otpremanje nedostaju obavezni parametri upita.
400invalid_request_errorNedostaje job_idVraćeno kada zahtev za renderovanje ne sadrži job_id.
400invalid_request_errorNema dostupnih izlaza za ovaj posaoVraćeno kada posao nema izlaze koji se mogu renderovati.
400invalid_request_errorinput_keys mora biti neprazan nizVraćeno kada `input_keys` nedostaje ili je prazan.
400invalid_request_errorinput_keys mora sadržati najmanje jedan važeći ključ ulazaVraćeno kada su svi navedeni ključevi ulaza prazni ili nevažeći nakon normalizacije.
400input_duration_requirement_errorUkupno trajanje ulaza mora biti duže od 2 sekundeVraćeno kada je zbirno trajanje svih ulaznih medija 2 sekunde ili manje.
400input_duration_requirement_errorUkupno trajanje ulaza mora biti manje od 6 satiVraćeno kada je zbirno trajanje svih ulaznih medija 6 sati ili više.
400input_image_count_requirement_errorBroj ulaznih slika ne sme biti veći od 4000Vraćeno kada broj ulaznih slika premašuje maksimalno dozvoljeni limit od 4000.
400input_video_count_requirement_errorBroj ulaznih video zapisa ne sme biti veći od 400Vraćeno kada broj ulaznih video zapisa premašuje maksimalno dozvoljeni limit od 400.
400invalid_request_errorNevažeća vrednost video_category. Dozvoljene vrednosti: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, othersVraćeno kada `video_category` nije podržan.
400invalid_request_errorNevažeća vrednost aspect_ratio. Dozvoljene vrednosti: square, portrait, landscapeVraćeno kada `aspect_ratio` nije podržan.
400invalid_request_erroroutput_length mora biti pozitivan brojVraćeno kada `output_length` nedostaje, je nula ili negativan.
400invalid_request_errorNije moguće odrediti pozitivno trajanje ulaza iz metapodataka input_keysVraćeno kada API ne može da odredi važeće trajanje za otpremljene ulaze.
400invalid_request_errormusic_volume mora biti broj između 0 i 100Vraćeno kada je `music_volume` prosleđen, ali nije važeći broj između 0 i 100.
400invalid_request_errororiginal_audio_volume mora biti broj između 0 i 100Vraćeno kada je `original_audio_volume` prosleđen, ali nije važeći broj između 0 i 100.
400invalid_request_errorNevažeća vrednost music_category. Dozvoljene vrednosti: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogsVraćeno kada je `music_category` prosleđen, ali ne odgovara nijednoj od podržanih muzičkih kategorija.
401authentication_errorNedostaje API ključVraćeno kada zaglavlje `x-api-key` nije prosleđeno.
401authentication_errorNevažeći API ključVraćeno kada prosleđeni API ključ ne odgovara aktivnom ključu.
402insufficient_balanceNemate dovoljno kredita za obradu ovog poslaVraćeno kada nalog nema dovoljno kredita za obradu ili renderovanje.
403permission_errorNemate dozvolu za pristup ovom posluVraćeno kada ulogovani korisnik nije vlasnik traženog posla.
403permission_errorNemate dozvolu za renderovanje ovog poslaVraćeno kada ulogovani korisnik nije vlasnik posla koji se renderuje.
404invalid_request_errorPosao nije pronađenVraćeno kada traženi posao ne postoji.
404invalid_request_errorKorisnik nije pronađenVraćeno kada zapis o ulogovanom korisniku ne može da se pronađe.
429rate_limit_errorPreviše zahtevaVrać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.
429rate_limit_errorVeć 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.
500api_errorGreška pri autentifikacijiVraćeno kada autentifikacija API ključa neočekivano zakaže na serveru.
500api_errorInterna greška serveraVraćeno za neočekivane greške na serverskoj strani u endpoint-ima za status, renderovanje ili highlight reel.
500server_errorNeuspešno generisanje URL-a za otpremanjeVraćeno kada server ne uspe da generiše potpisani URL za otpremanje.