Chyby

API VIDIO používá konzistentní formát objektu chyby. Použijte tuto stránku k pochopení běžných typů chyb, stavových kódů HTTP a příkladových zpráv vracených API.

API přístup je v současné době k dispozici pouze pro plán Studio a vyšší.

Přehled

Když požadavek selže, API VIDIO vrátí objekt error s type a message. Některé chyby mohou také obsahovat další pole pro vysvětlení selhání.

Formát chyby

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Práce nebyla nalezena"
  }
}

Reference chyb

Status	Type	Message	Description
400	invalid_request_error	V žádosti o URL pro nahrání chybí povinné parametry dotazu	Vráceno, když v žádosti o upload URL chybí povinné parametry dotazu.
400	invalid_request_error	Chybí job_id	Vráceno, když požadavek na renderování neobsahuje ID úlohy.
400	invalid_request_error	Pro tento úkol nejsou dostupné žádné výstupy	Vráceno, když úloha nemá žádné výstupy, které by bylo možné renderovat.
400	invalid_request_error	input_keys must be a non-empty array	Vráceno, když `input_keys` chybí nebo je prázdné.
400	invalid_request_error	input_keys must contain at least one valid input key	Vráceno, když jsou po normalizaci všechny zadané vstupní klíče prázdné nebo neplatné.
400	input_duration_requirement_error	Total input duration must be greater than 2 seconds	Vráceno, když je kombinovaná délka všech vstupních médií 2 sekundy nebo méně.
400	input_duration_requirement_error	Total input duration must be less than 6 hours	Vráceno, když je kombinovaná délka všech vstupních médií 6 hodin nebo více.
400	input_image_count_requirement_error	Number of input images must be no more than 4000	Vráceno, když počet vstupních obrázků překročí maximální povolený limit 4000.
400	input_video_count_requirement_error	Number of input videos must be no more than 400	Vráceno, když počet vstupních videí překročí maximální povolený limit 400.
400	invalid_request_error	Neplatné video_category. Povolené hodnoty: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Vráceno, když `video_category` není podporováno.
400	invalid_request_error	Neplatné aspect_ratio. Povolené hodnoty: square, portrait, landscape	Vráceno, když `aspect_ratio` není podporován.
400	invalid_request_error	output_length musí být kladné číslo	Vráceno, když `output_length` chybí, je nula nebo záporné.
400	invalid_request_error	Nepodařilo se určit kladnou délku vstupu z metadat input_keys	Vráceno, když API nemůže určit platnou délku pro nahrané vstupy.
400	invalid_request_error	music_volume musí být číslo mezi 0 a 100	Vráceno, když je `music_volume` poskytnuto, ale není platné číslo mezi 0 a 100.
400	invalid_request_error	original_audio_volume musí být číslo mezi 0 a 100	Vráceno, když je `original_audio_volume` poskytnuto, ale není platné číslo mezi 0 a 100.
400	invalid_request_error	Neplatné music_category. Povolené hodnoty: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Vráceno, když je `music_category` poskytnuta, ale neodpovídá žádné z podporovaných kategorií hudby.
401	authentication_error	Chybí API klíč	Vráceno, když není poskytnuta hlavička `x-api-key`.
401	authentication_error	Neplatný API klíč	Vráceno, když poskytnutý API klíč neodpovídá žádnému aktivnímu klíči.
402	insufficient_balance	Nemáte dostatek kreditů na zpracování tohoto jobu	Vráceno, když účet nemá dostatek kreditů pro zpracování nebo renderování.
403	permission_error	Nemáte oprávnění k přístupu k tomuto jobu	Vráceno, když autentizovaný uživatel nevlastní požadovaný job.
403	permission_error	Nemáte oprávnění renderovat tento job	Vráceno, když autentizovaný uživatel nevlastní job, který se renderuje.
404	invalid_request_error	Job nenalezen	Vráceno, když požadovaný job neexistuje.
404	invalid_request_error	Uživatel nenalezen	Vráceno, když záznam autentizovaného uživatele nelze najít.
429	rate_limit_error	Příliš mnoho požadavků	Vráceno, když klient překročí povolenou rychlost požadavků pro tento endpoint. Aktuální limit je 60 požadavků za minutu. Omezování rychlosti se primárně uplatňuje na základě API klíče pomocí hlavičky `x-api-key` a v případě, že API klíč není přítomen, se použije IP adresa klienta. Klienti, kteří narazí na tento limit, by měli snížit frekvenci požadavků a zopakovat pokus poté, co se okno omezení rychlosti obnoví.
429	rate_limit_error	Už máte 10 běžících nebo zařazených jobů, což je maximální povolený počet. Počkejte prosím, až některé joby dokončí, než odešlete další.	Vráceno, když uživatel již dosáhl maximálního povoleného počtu probíhajících jobů, včetně běžících jobů na serverech a čekajících jobů v frontě. Aktuální limit je 10 celkových běžících nebo zařazených jobů na uživatele. Vlastnictví se určuje porovnáním každého `job_id` na zatížených serverech a záznamech v čekací frontě se `user_email` jobu. Klienti, kteří narazí na tento limit, by měli počkat, až jeden nebo více existujících jobů dokončí, než vytvoří nebo renderují další job.
500	api_error	Chyba autentizace	Vráceno, když na serveru neočekávaně selže autentizace pomocí API klíče.
500	api_error	Vnitřní chyba serveru	Vráceno při neočekávaných chybách na straně serveru v endpointech pro status, render nebo highlight reel.
500	server_error	Nepodařilo se vygenerovat URL pro nahrání	Vráceno, když server nedokáže vygenerovat podepsanou URL pro nahrání.