Fouten

De VIDIO API gebruikt een consistent foutobjectformaat. Gebruik deze pagina om veelvoorkomende fouttypes, HTTP-statuscodes en voorbeeldberichten die door de API worden geretourneerd, te begrijpen.

API-toegang is momenteel beschikbaar voor het Studio-plan en hoger.

Overzicht

Wanneer een verzoek faalt, retourneert de VIDIO API een error object met een type en message. Sommige fouten kunnen ook aanvullende velden bevatten om de fout te helpen verklaren.

Foutformaat

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Opdracht niet gevonden"
  }
}

Foutreferentie

Status	Type	Message	Description
400	invalid_request_error	Ontbrekende vereiste queryparameters in upload-URL-verzoek	Teruggegeven wanneer verplichte queryparameters ontbreken in het upload-URL-verzoek.
400	invalid_request_error	Ontbrekende job_id	Teruggegeven wanneer het renderverzoek geen job-ID bevat.
400	invalid_request_error	Geen uitvoer beschikbaar voor deze job	Teruggegeven wanneer de job geen renderbare uitvoer heeft.
400	invalid_request_error	input_keys moet een niet-lege array zijn	Teruggegeven wanneer `input_keys` ontbreekt of leeg is.
400	invalid_request_error	input_keys moet ten minste één geldige invoersleutel bevatten	Teruggegeven wanneer alle opgegeven input keys leeg of ongeldig zijn na normalisatie.
400	input_duration_requirement_error	Totale invoerduur moet meer dan 2 seconden zijn	Teruggegeven wanneer de gecombineerde duur van alle invoermedia 2 seconden of minder is.
400	input_duration_requirement_error	Totale invoerduur moet minder dan 6 uur zijn	Teruggegeven wanneer de gecombineerde duur van alle invoermedia 6 uur of meer is.
400	input_image_count_requirement_error	Aantal invoerafbeeldingen mag niet meer dan 4000 zijn	Teruggegeven wanneer het aantal invoerafbeeldingen het maximaal toegestane limiet van 4000 overschrijdt.
400	input_video_count_requirement_error	Aantal invoervideo's mag niet meer dan 400 zijn	Teruggegeven wanneer het aantal invoervideo's het maximaal toegestane limiet van 400 overschrijdt.
400	invalid_request_error	Ongeldige video_category. Toegestane waarden: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Teruggegeven wanneer `video_category` niet wordt ondersteund.
400	invalid_request_error	Ongeldige aspect_ratio. Toegestane waarden: square, portrait, landscape	Teruggegeven wanneer `aspect_ratio` niet wordt ondersteund.
400	invalid_request_error	output_length moet een positief getal zijn	Teruggegeven wanneer `output_length` ontbreekt, nul of negatief is.
400	invalid_request_error	Kon geen positieve invoerduur bepalen uit de metadata van input_keys	Teruggegeven wanneer de API geen geldige duur voor de geüploade inputs kan bepalen.
400	invalid_request_error	music_volume moet een getal tussen 0 en 100 zijn	Teruggegeven wanneer `music_volume` is opgegeven maar geen geldig getal tussen 0 en 100 is.
400	invalid_request_error	original_audio_volume moet een getal tussen 0 en 100 zijn	Teruggegeven wanneer `original_audio_volume` is opgegeven maar geen geldig getal tussen 0 en 100 is.
400	invalid_request_error	Ongeldige music_category. Toegestane waarden: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Teruggegeven wanneer `music_category` is opgegeven maar niet overeenkomt met een van de ondersteunde muziekcategorieën.
401	authentication_error	Ontbrekende API-sleutel	Teruggegeven wanneer de `x-api-key` header niet is meegeleverd.
401	authentication_error	Ongeldige API-sleutel	Teruggegeven wanneer de opgegeven API-sleutel niet overeenkomt met een actieve sleutel.
402	insufficient_balance	Je hebt niet genoeg credits om deze job te verwerken	Teruggegeven wanneer het account niet genoeg credits heeft voor verwerking of rendering.
403	permission_error	Je hebt geen toestemming om toegang te krijgen tot deze job	Teruggegeven wanneer de geauthenticeerde gebruiker de opgevraagde job niet bezit.
403	permission_error	Je hebt geen toestemming om deze job te renderen	Teruggegeven wanneer de geauthenticeerde gebruiker de job die gerenderd wordt niet bezit.
404	invalid_request_error	Job niet gevonden	Teruggegeven wanneer de opgevraagde job niet bestaat.
404	invalid_request_error	Gebruiker niet gevonden	Teruggegeven wanneer het gebruikersrecord van de geauthenticeerde gebruiker niet kan worden gevonden.
429	rate_limit_error	Te veel verzoeken	Teruggegeven wanneer de client de toegestane aanvraagfrequentie voor de endpoint overschrijdt. De huidige limiet is 60 verzoeken per minuut. Rate limiting wordt primair toegepast per API-sleutel met de x-api-key header, en valt terug op het IP-adres van de client wanneer er geen API-sleutel aanwezig is. Clients die deze limiet bereiken, moeten de frequentie van aanvragen verlagen en opnieuw proberen nadat het rate-limit-venster is gereset.
429	rate_limit_error	Je hebt al 10 lopende of in wachtrij staande jobs, wat het maximaal toegestane aantal is. Wacht tot enkele jobs zijn voltooid voordat je een nieuwe indient.	Teruggegeven wanneer de gebruiker al het maximaal toegestane aantal lopende jobs heeft, zowel voor actieve jobs op servers als voor in de wachtrij staande jobs. De huidige limiet is in totaal 10 lopende of in wachtrij staande jobs per gebruiker. Eigendom wordt bepaald door elk job_id op bezette servers en wachtrij-items te matchen met de user_email van de job. Clients die deze limiet bereiken, moeten wachten tot een of meer bestaande jobs zijn voltooid voordat ze een andere job aanmaken of renderen.
500	api_error	Authenticatiefout	Teruggegeven wanneer API-sleutelauthenticatie onverwacht op de server faalt.
500	api_error	Interne serverfout	Teruggegeven voor onverwachte serverfouten in de status-, render- of highlight-reel-endpoints.
500	server_error	Kon geen upload-URL genereren	Teruggegeven wanneer de server er niet in slaagt een ondertekende upload-URL te genereren.