Fel

VIDIO API använder ett konsekvent format för felobjekt. Använd den här sidan för att förstå vanliga feltyper, HTTP-statuskoder och exempelmeddelanden som returneras av API:et.

API-åtkomst är för närvarande tillgänglig för Studio-planen och högre.

Översikt

När en begäran misslyckas returnerar VIDIO API ett error objekt med en type och message. Vissa fel kan också inkludera ytterligare fält för att hjälpa till att förklara felet.

Fel format

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Jobb hittades inte"
  }
}

Felreferens

Status	Type	Message	Description
400	invalid_request_error	Saknade obligatoriska frågeparametrar i begäran om uppladdnings-URL	Returneras när obligatoriska frågeparametrar saknas i begäran om uppladdnings-URL.
400	invalid_request_error	Saknas job_id	Returneras när renderingsbegäran inte innehåller ett job ID.
400	invalid_request_error	Inga utdata tillgängliga för detta jobb	Returneras när jobbet inte har några renderbara utdata.
400	invalid_request_error	input_keys måste vara en icke-tom array	Returneras när `input_keys` saknas eller är tom.
400	invalid_request_error	input_keys måste innehålla minst en giltig input-nyckel	Returneras när alla angivna input-nycklar är tomma eller ogiltiga efter normalisering.
400	input_duration_requirement_error	Total inmatningstid måste vara större än 2 sekunder	Returneras när den sammanlagda längden för allt inmatat media är 2 sekunder eller mindre.
400	input_duration_requirement_error	Total inmatningstid måste vara mindre än 6 timmar	Returneras när den sammanlagda längden för allt inmatat media är 6 timmar eller mer.
400	input_image_count_requirement_error	Antalet inmatningsbilder får inte överstiga 4000	Returneras när antalet inmatningsbilder överskrider den högsta tillåtna gränsen på 4000.
400	input_video_count_requirement_error	Antalet inmatningsvideor får inte överstiga 400	Returneras när antalet inmatningsvideor överskrider den högsta tillåtna gränsen på 400.
400	invalid_request_error	Ogiltig video_category. Tillåtna värden: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Returneras när `video_category` inte stöds.
400	invalid_request_error	Ogiltig aspect_ratio. Tillåtna värden: square, portrait, landscape	Returneras när `aspect_ratio` inte stöds.
400	invalid_request_error	output_length måste vara ett positivt tal	Returneras när `output_length` saknas, är noll eller negativ.
400	invalid_request_error	Kunde inte avgöra en positiv inmatningstid från input_keys metadata	Returneras när API:et inte kan fastställa en giltig varaktighet för de uppladdade inslagen.
400	invalid_request_error	music_volume måste vara ett tal mellan 0 och 100	Returneras när `music_volume` anges men inte är ett giltigt tal mellan 0 och 100.
400	invalid_request_error	original_audio_volume måste vara ett tal mellan 0 och 100	Returneras när `original_audio_volume` anges men inte är ett giltigt tal mellan 0 och 100.
400	invalid_request_error	Ogiltig music_category. Tillåtna värden: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Returneras när `music_category` anges men inte matchar någon av de stödda musikategorierna.
401	authentication_error	Saknas API-nyckel	Returneras när `x-api-key`-huvudet inte är angivet.
401	authentication_error	Ogiltig API-nyckel	Returneras när den angivna API-nyckeln inte matchar en aktiv nyckel.
402	insufficient_balance	Du har inte tillräckligt med krediter för att bearbeta detta jobb	Returneras när kontot inte har tillräckligt med krediter för bearbetning eller rendering.
403	permission_error	Du har inte behörighet att komma åt detta jobb	Returneras när den autentiserade användaren inte äger det begärda jobbet.
403	permission_error	Du har inte behörighet att rendera detta jobb	Returneras när den autentiserade användaren inte äger det jobb som renderas.
404	invalid_request_error	Jobbet hittades inte	Returneras när det begärda jobbet inte finns.
404	invalid_request_error	Användaren hittades inte	Returneras när den autentiserade användarens post inte kan hittas.
429	rate_limit_error	För många förfrågningar	Returneras när klienten överskrider den tillåtna förfrågningsfrekvensen för slutpunkten. Den aktuella gränsen är 60 förfrågningar per minut. Begränsning av förfrågningsfrekvens tillämpas i första hand per API-nyckel via x-api-key-huvudet, och faller tillbaka till klientens IP-adress när en API-nyckel inte är närvarande. Klienter som når denna gräns bör minska förfrågningsfrekvensen och försöka igen efter att fönstret för begränsning återställts.
429	rate_limit_error	Du har redan 10 körande eller köade jobb, vilket är max tillåtet. Vänta tills några jobb har slutförts innan du skickar in ett nytt.	Returneras när användaren redan har det högsta tillåtna antalet pågående jobb, både körande jobb på servrar och väntande jobb i kön. Den aktuella gränsen är totalt 10 körande eller köade jobb per användare. Ägarskap fastställs genom att matcha varje job_id på upptagna servrar och väntande köposter mot jobbets user_email. Klienter som når denna gräns bör vänta tills ett eller flera befintliga jobb slutförts innan de skapar eller renderar ett annat jobb.
500	api_error	Autentiseringsfel	Returneras när API-nyckelautentisering misslyckas oväntat på servern.
500	api_error	Internt serverfel	Returneras för oväntade serverfel i status-, render- eller highlight-reel-slutpunkter.
500	server_error	Misslyckades med att generera uppladdnings-URL	Returneras när servern misslyckas med att generera en signerad uppladdnings-URL.