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 alleen beschikbaar voor Enterprise-plannen. Vraag toegang aan hier als je geen Enterprise-gebruiker bent maar geïnteresseerd bent in het gebruik van de API.

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	Vereiste queryparameters ontbreken in upload-URL-verzoek	Geretourneerd wanneer vereiste queryparameters ontbreken in het upload-URL-verzoek.
400	invalid_request_error	job_id ontbreekt	Geretourneerd wanneer het renderverzoek geen job-ID bevat.
400	invalid_request_error	Geen uitvoer beschikbaar voor deze opdracht	Geretourneerd wanneer de job geen renderbare uitvoer heeft.
400	invalid_request_error	input_keys moet een niet-lege array zijn	Geretourneerd wanneer `input_keys` ontbreekt of leeg is.
400	invalid_request_error	input_keys moet ten minste één geldige invoersleutel bevatten	Geretourneerd wanneer alle opgegeven invoersleutels leeg of ongeldig zijn na normalisatie.
400	invalid_request_error	Ongeldige video_category. Toegestane waarden: podcast, balsporten, niet-balsporten, beauty-product-demonstratie, bruiloft, reizen, anderen	Geretourneerd wanneer `video_category` niet wordt ondersteund.
400	invalid_request_error	Ongeldige aspect_ratio. Toegestane waarden: vierkant, portret, landschap	Geretourneerd wanneer `aspect_ratio` niet wordt ondersteund.
400	invalid_request_error	output_length moet een positief getal zijn	Geretourneerd wanneer `output_length` ontbreekt, nul of negatief is.
400	invalid_request_error	Kon positieve invoerduratie niet bepalen uit input_keys metadata	Geretourneerd wanneer de API geen geldige duur kan bepalen voor de geüploade invoer.
401	authentication_error	API-sleutel ontbreekt	Geretourneerd wanneer de `x-api-key` header niet is meegeleverd.
401	authentication_error	Ongeldige API-sleutel	Geretourneerd wanneer de opgegeven API-sleutel niet overeenkomt met een actieve sleutel.
402	insufficient_balance	Je hebt niet genoeg credits om deze opdracht te verwerken	Geretourneerd wanneer het account niet genoeg credits heeft voor verwerking of rendering.
403	permission_error	Je hebt geen toestemming om deze opdracht te benaderen	Geretourneerd wanneer de geauthenticeerde gebruiker niet de eigenaar is van de aangevraagde opdracht.
403	permission_error	Je hebt geen toestemming om deze opdracht te renderen	Geretourneerd wanneer de geauthenticeerde gebruiker niet de eigenaar is van de opdracht die wordt gerenderd.
404	invalid_request_error	Opdracht niet gevonden	Geretourneerd wanneer de aangevraagde opdracht niet bestaat.
404	invalid_request_error	Gebruiker niet gevonden	Geretourneerd wanneer het record van de geauthenticeerde gebruiker niet kan worden gevonden.
429	rate_limit_error	Te veel verzoeken	Geretourneerd wanneer de client de toegestane aanvraaglimiet voor de eindpunt overschrijdt. De huidige limiet is 60 aanvragen per minuut. Rate limiting wordt voornamelijk toegepast per API-sleutel met behulp van 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 overschrijden, moeten de aanvraagfrequentie verlagen en opnieuw proberen nadat het rate limit-venster is gereset.
500	api_error	Authenticatie fout	Geretourneerd wanneer de authenticatie met de API-sleutel onverwacht mislukt op de server.
500	api_error	Interne serverfout	Geretourneerd voor onverwachte serverzijde fouten in status, render, of highlight reel eindpunten.
500	server_error	Kon upload-URL niet genereren	Geretourneerd wanneer de server niet in staat is om een ondertekende upload-URL te genereren.