Hibák

A VIDIO API egy következetes hibákat tartalmazó objektumformát használ. Használja ezt az oldalt a gyakori hibatípusok, HTTP állapotkódok és az API által visszaadott példamondatok megértésére.

Az API-hozzáférés jelenleg a Studio terv és az annál magasabb szint számára érhető el.

Áttekintés

Amikor egy kérés meghiúsul, a VIDIO API visszaad egy error objektumot egy type és egy message mezővel. Néhány hiba további mezőket is tartalmazhat a meghibásodás magyarázatához.

Hibaformátum

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "A munka nem található"
  }
}

Hiba referencia

Status	Type	Message	Description
400	invalid_request_error	Visszaadva, ha az upload URL kérésből hiányoznak a szükséges lekérdezési paraméterek	Visszaadva, ha az upload URL kérésből hiányoznak a szükséges lekérdezési paraméterek.
400	invalid_request_error	Hiányzik a job_id	Visszaadva, ha a render kérelem nem tartalmaz job ID-t.
400	invalid_request_error	Ehhez a munkához nincs elérhető kimenet	Visszaadva, ha a munkának nincs renderelhető kimenete.
400	invalid_request_error	input_keys must be a non-empty array	Visszaadva, ha a `input_keys` hiányzik vagy üres.
400	invalid_request_error	input_keys must contain at least one valid input key	Visszaadva, ha az összes megadott input kulcs üres vagy normalizálás után érvénytelen.
400	input_duration_requirement_error	A bemenetek összhossza többnek kell lennie, mint 2 másodperc	Visszaadva, ha az összes bemeneti média együttes hossza 2 másodperc vagy kevesebb.
400	input_duration_requirement_error	A bemenetek összhossza kevesebb kell legyen, mint 6 óra	Visszaadva, ha az összes bemeneti média együttes hossza 6 óra vagy több.
400	input_image_count_requirement_error	A bemeneti képek száma legfeljebb 4000 lehet	Visszaadva, ha a bemeneti képek száma meghaladja a megengedett, legfeljebb 4000-as korlátot.
400	input_video_count_requirement_error	A bemeneti videók száma legfeljebb 400 lehet	Visszaadva, ha a bemeneti videók száma meghaladja a megengedett, legfeljebb 400-as korlátot.
400	invalid_request_error	Érvénytelen video_category. Engedélyezett értékek: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Visszaadva, ha a `video_category` nincs támogatva.
400	invalid_request_error	Érvénytelen aspect_ratio. Engedélyezett értékek: square, portrait, landscape	Visszaadva, ha a `aspect_ratio` nincs támogatva.
400	invalid_request_error	Az output_length-nek pozitív számnak kell lennie	Visszaadva, ha az `output_length` hiányzik, nulla vagy negatív.
400	invalid_request_error	Nem sikerült pozitív bemeneti időtartamot meghatározni az input_keys metaadataiból	Visszaadva, ha az API nem tud érvényes időtartamot meghatározni a feltöltött bemenetekhez.
400	invalid_request_error	A music_volume-nak 0 és 100 közötti számnak kell lennie	Visszaadva, ha megadták a `music_volume`-t, de az nem érvényes, 0 és 100 közötti szám.
400	invalid_request_error	Az original_audio_volume-nak 0 és 100 közötti számnak kell lennie	Visszaadva, ha megadták az `original_audio_volume`-t, de az nem érvényes, 0 és 100 közötti szám.
400	invalid_request_error	Érvénytelen music_category. Engedélyezett értékek: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Visszaadva, ha megadták a `music_category`-t, de az nem egyezik meg a támogatott zenei kategóriák egyikével.
401	authentication_error	Hiányzik az API-kulcs	Visszaadva, ha a `x-api-key` fejléc nincs megadva.
401	authentication_error	Érvénytelen API-kulcs	Visszaadva, ha a megadott API-kulcs nem egyezik meg egy aktív kulccsal.
402	insufficient_balance	Nincs elegendő kredited ennek a munkának a feldolgozásához	Visszaadva, ha a fióknak nincs elegendő kreditje a feldolgozáshoz vagy a rendereléshez.
403	permission_error	Nincs jogosultságod hozzáférni ehhez a munkához	Visszaadva, ha a hitelesített felhasználó nem a kért munka tulajdonosa.
403	permission_error	Nincs jogosultságod megrenderelni ezt a munkát	Visszaadva, ha a hitelesített felhasználó nem a renderelendő munka tulajdonosa.
404	invalid_request_error	A munka nem található	Visszaadva, ha a kért munka nem létezik.
404	invalid_request_error	Felhasználó nem található	Visszaadva, ha a hitelesített felhasználó rekordja nem található.
429	rate_limit_error	Túl sok kérés	Visszaadva, amikor az ügyfél meghaladja az adott végpontra engedélyezett kérések sebességét. A jelenlegi limit 60 kérés percenként. A sebességkorlátozás elsősorban API-kulcsonként alkalmazódik az x-api-key fejléc használatával, és ha nincs API-kulcs, akkor az ügyfél IP-címére esik vissza. Azok az ügyfelek, akik elérik ezt a korlátot, csökkentsék a kérések gyakoriságát, és próbálkozzanak újra, miután a sebességkorlátozás ablaka visszaáll.
429	rate_limit_error	Már 10 futó vagy sorban álló munkád van, ami a maximálisan megengedett. Kérjük, várj, amíg néhány munka befejeződik, mielőtt egy újat küldenél be.	Visszaadva, ha a felhasználónak már megvan a folyamatban lévő munkák megengedett maximális száma, beleértve a szervereken futó és a sorban várakozó munkákat. A jelenlegi korlát felhasználónként összesen 10 futó vagy sorban álló munka. A tulajdonjogot úgy állapítják meg, hogy az elfoglalt szerverek és a sorban várakozó bejegyzések egyes job_id-jeit visszamatchelik a munka user_email-jéhez. Azok az ügyfelek, akik elérik ezt a korlátot, várjanak meg egy vagy több meglévő munka befejezését, mielőtt egy újat létrehoznának vagy renderelnének.
500	api_error	Hitelesítési hiba	Visszaadva, ha az API-kulcs hitelesítése váratlanul meghiúsul a szerveren.
500	api_error	Belső szerverhiba	Visszaadva nem várt szerveroldali hibák esetén a status, render vagy highlight reel végpontoknál.
500	server_error	Nem sikerült létrehozni az upload URL-t	Visszaadva, ha a szerver nem tud létrehozni egy aláírt upload URL-t.