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 endast för företagsplaner. Begär åtkomst här om du inte är en företagsanvändare men är intresserad av att använda API:et.

Ö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 uppladdnings-URL-begäran	Returneras när obligatoriska frågeparametrar saknas i uppladdnings-URL-begäran.
400	invalid_request_error	Saknad job_id	Returneras när renderingsbegäran inte inkluderar 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 inputnyckel	Returneras när alla angivna inputnycklar är tomma eller ogiltiga efter normalisering.
400	invalid_request_error	Ogiltig video_category. Tillåtna värden: podcast, boll-idrotter, icke-boll-idrotter, skönhetsprodukt-demonstration, bröllop, resa, andra	Returneras när `video_category` inte stöds.
400	invalid_request_error	Ogiltig aspect_ratio. Tillåtna värden: fyrkantig, porträtt, landskap	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 fastställa positiv ingångsvaraktighet från input_keys metadata	Returneras när API:et inte kan avgöra en giltig varaktighet för de uppladdade ingångarna.
401	authentication_error	Saknad API-nyckel	Returneras när `x-api-key`-huvudet inte tillhandahålls.
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 jobbet som renderas.
404	invalid_request_error	Jobb hittades inte	Returneras när det begärda jobbet inte existerar.
404	invalid_request_error	Användare hittades inte	Returneras när den autentiserade användarens post inte kan hittas.
429	rate_limit_error	För många begärningar	Returneras när klienten överskrider den tillåtna begärningsfrekvensen för slutpunkten. Den aktuella gränsen är 60 begärningar per minut. Hastighetsbegränsning tillämpas främst per API-nyckel med hjälp av 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 begärningsfrekvensen och försöka igen efter att hastighetsbegränsningsfönstret har återställts.
500	api_error	Autentiseringsfel	Returneras när API-nyckelautentisering misslyckas oväntat på servern.
500	api_error	Internt serverfel	Returneras för oväntade server-sidiga fel i status, rendering eller höjdpunkter.
500	server_error	Kunde inte generera uppladdnings-URL	Returneras när servern misslyckas med att generera en signerad uppladdnings-URL.