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.

Pristup API-ju trenutno je dostupan samo za Enterprise planove. Zatražite pristup ovde ako niste Enterprise korisnik, ali vas zanima korišćenje API-ja.

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 zahtevima za upload URL	Vraća se kada nedostaju obavezni parametri upita iz zahteva za upload URL.
400	invalid_request_error	Nedostaje job_id	Vraća se kada zahtev za render ne uključuje ID posla.
400	invalid_request_error	Nema dostupnih izlaza za ovaj posao	Vraća se kada posao nema nijedan izlaz koji se može renderovati.
400	invalid_request_error	input_keys moraju biti nenulni niz	Vraća se kada `input_keys` nedostaje ili je prazan.
400	invalid_request_error	input_keys moraju sadržati barem jedan validan ključ ulaza	Vraća se kada su svi pruženi ključevi ulaza prazni ili nevalidni nakon normalizacije.
400	invalid_request_error	Nevalidna video_kategorija. Dozvoljene vrednosti: podcast, sportovi s loptom, sportovi bez lopte, demo proizvoda za lepotu, venčanje, putovanje, ostalo	Vraća se kada `video_kategorija` nije podržana.
400	invalid_request_error	Nevalidan aspect_ratio. Dozvoljene vrednosti: kvadrat, portret, pejzaž	Vraća se kada `aspect_ratio` nije podržan.
400	invalid_request_error	output_length mora biti pozitivna brojka	Vraća se kada `output_length` nedostaje, je nula ili negativan.
400	invalid_request_error	Nije moguće odrediti pozitivnu dužinu ulaza iz metadata input_keys	Vraća se kada API ne može odrediti validnu dužinu za učitane ulaze.
401	authentication_error	Nedostaje API ključ	Vraća se kada `x-api-key` zaglavlje nije pruženo.
401	authentication_error	Nevalidan API ključ	Vraća se kada pruženi API ključ ne odgovara aktivnom ključi.
402	insufficient_balance	Nemate dovoljno kredita za obradu ovog posla	Vraća se kada račun nema dovoljno kredita za obradu ili renderovanje.
403	permission_error	Nemate dozvolu za pristup ovom poslu	Vraća se kada autentifikovani korisnik ne poseduje zatraženi posao.
403	permission_error	Nemate dozvolu za renderovanje ovog posla	Vraća se kada autentifikovani korisnik ne poseduje posao koji se renderuje.
404	invalid_request_error	Posao nije pronađen	Vraća se kada zatraženi posao ne postoji.
404	invalid_request_error	Korisnik nije pronađen	Vraća se kada se ne može pronaći zapis autentifikovanog korisnika.
429	rate_limit_error	Previše zahteva	Vraća se kada klijent premaši dozvoljenu stopu zahteva za endpoint. Trenutni limit je 60 zahteva u minutu. Ograničenje brzine se primenjuje prvenstveno po API ključu koristeći x-api-key zaglavlje, a vraća se na IP adresu klijenta kada API ključ nije prisutan. Klijenti koji dostignu ovaj limit treba da smanje učestalost zahteva i ponovo pokušaju nakon što se prozor ograničenja brzine resetuje.
500	api_error	Greška autentifikacije	Vraća se kada autentifikacija API ključa iznenada ne uspe na serveru.
500	api_error	Interna greška servera	Vraća se zbog nepredviđenih grešaka na strani servera u statusima, renderu ili istaknutim točenjima.
500	server_error	Nije uspelo generisanje upload URL	Vraća se kada server ne uspe da generiše potpisani upload URL.