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.

API hozzáférés jelenleg csak Vállalati tervekhez érhető el. Kérjük, kérje a hozzáférést itt, ha nem Vállalati felhasználó, de érdekli az API használata.

Á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	Hiányzó kötelező lekérdezési paraméterek az upload URL kérésben	Akkor adódik, ha a kötelező lekérdezési paraméterek hiányoznak az upload URL kérésből.
400	invalid_request_error	Hiányzó job_id	Akkor adódik, ha a render kérés nem tartalmaz job ID-t.
400	invalid_request_error	Nincsenek elérhető kimenetek ehhez a munkához	Akkor adódik, ha a munkának nincsenek renderelhető kimenetei.
400	invalid_request_error	az input_keys nem lehet üres tömb	Akkor adódik, ha az `input_keys` hiányzik vagy üres.
400	invalid_request_error	az input_keys-nek tartalmaznia kell legalább egy érvényes input kulcsot	Akkor adódik, ha az összes megadott input kulcs üres vagy érvénytelen a normalizálás után.
400	invalid_request_error	Érvénytelen video_category. Megengedett értékek: podcast, labdajátékok, nem-labdajátékok, szépségápolási termék bemutató, esküvő, utazás, egyéb	Akkor adódik, ha a `video_category` nem támogatott.
400	invalid_request_error	Érvénytelen aspect_ratio. Megengedett értékek: négyzet, portré, tájkép	Akkor adódik, ha az `aspect_ratio` nem támogatott.
400	invalid_request_error	output_length pozitív számnak kell lennie	Akkor adódik, ha az `output_length` hiányzik, nulla vagy negatív.
400	invalid_request_error	Nem sikerült meghatározni a pozitív bemeneti időt az input_keys metaadatokból	Akkor adódik, ha az API nem tud érvényes időt meghatározni a feltöltött bemenetek számára.
401	authentication_error	Hiányzó API kulcs	Akkor adódik, ha az `x-api-key` fejléc nincs megadva.
401	authentication_error	Érvénytelen API kulcs	Akkor adódik, ha a megadott API kulcs nem egyezik egy aktív kulccsal.
402	insufficient_balance	Nincs elegendő kredited ennek a munkának a feldolgozásához	Akkor adódik, ha a fióknak nincs elegendő kredite a feldolgozáshoz vagy rendereléshez.
403	permission_error	Nincs engedélye hozzáférni ehhez a munkához	Akkor adódik, ha a hitelesített felhasználó nem birtokolja a kérdéses munkát.
403	permission_error	Nincs engedélye renderelni ezt a munkát	Akkor adódik, ha a hitelesített felhasználó nem birtokolja a renderelendő munkát.
404	invalid_request_error	A munka nem található	Akkor adódik, ha a kért munka nem létezik.
404	invalid_request_error	Felhasználó nem található	Akkor adódik, ha a hitelesített felhasználó rekord nem található.
429	rate_limit_error	Túl sok kérés	Akkor adódik, ha az ügyfél túllépi a megengedett kérési sebességet az végpont számára. Az aktuális korlátozás 60 kérés percenként. A sebességkorlátozást elsősorban az API kulcsra alkalmazzák az x-api-key fejléc használatával, és visszafordul az ügyfél IP-címére, ha az API kulcs nem áll rendelkezésre. Azok az ügyfelek, akik elérik ezt a határt, csökkentsék a kérés gyakoriságát, és újrapróbálkozzanak a sebességkorlátozási ablak visszaállítása után.
500	api_error	Hitelesítési hiba	Akkor adódik, amikor az API kulcs hitelesítése váratlanul megbukik a szerveren.
500	api_error	Belső szerverhiba	Akkor adódik, ha váratlan szerveroldali hibák lépnek fel a státusz, renderelés vagy kiemelt videó végpontokban.
500	server_error	Nem sikerült létrehozni az upload URL-t	Akkor adódik, amikor a szerver nem tud aláírt upload URL-t generálni.