Fejl

VIDIO API bruger et konsistent fejlobjektformat. Brug denne side til at forstå almindelige fejlkategorier, HTTP-statuskoder og eksempelbeskeder, der returneres af API'en.

API-adgang er i øjeblikket kun tilgængelig for Enterprise-planer. Anmod om adgang her, hvis du ikke er en Enterprise-bruger, men er interesseret i at bruge API'en.

Oversigt

Når en anmodning mislykkes, returnerer VIDIO API et fejl objekt med en type og besked. Nogle fejl kan også inkludere yderligere felter for at hjælpe med at forklare fejlen.

Fejlformat

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Job ikke fundet"
  }
}

Fejlreference

Status	Type	Message	Description
400	invalid_request_error	Mangler nødvendige forespørgselsparametre i upload URL-anmodning	Returneret når nødvendige forespørgselsparametre mangler i upload URL-anmodningen.
400	invalid_request_error	Mangler job_id	Returneret når render-anmodningen ikke inkluderer et job-ID.
400	invalid_request_error	Ingen output tilgængelige for dette job	Returneret når jobbet ikke har nogen renderbare outputs.
400	invalid_request_error	input_keys skal være et ikke-tomt array	Returneret når `input_keys` mangler eller er tomt.
400	invalid_request_error	input_keys skal indeholde mindst én gyldig inputnøgle	Returneret når alle angivne inputnøgler er blanke eller ugyldige efter normalisering.
400	invalid_request_error	Ugyldig video_category. Tilladte værdier: podcast, boldsport, ikke-boldsport, skønhedsprodukt-demo, bryllup, rejse, andre	Returneret når `video_category` ikke understøttes.
400	invalid_request_error	Ugyldig aspect_ratio. Tilladte værdier: kvadratisk, portræt, landskab	Returneret når `aspect_ratio` ikke understøttes.
400	invalid_request_error	output_length skal være et positivt tal	Returneret når `output_length` mangler, er nul eller negativ.
400	invalid_request_error	Kunne ikke bestemme positiv inputvarighed fra input_keys metadata	Returneret når API'en ikke kan bestemme en gyldig varighed for de uploadede inputs.
401	authentication_error	Mangler API-nøgle	Returneret når `x-api-key` headeren ikke er angivet.
401	authentication_error	Ugyldig API-nøgle	Returneret når den angivne API-nøgle ikke matcher en aktiv nøgle.
402	insufficient_balance	Du har ikke nok credits til at behandle dette job	Returneret når kontoen ikke har nok credits til behandling eller rendering.
403	permission_error	Du har ikke tilladelse til at få adgang til dette job	Returneret når den autentificerede bruger ikke ejer det anmodede job.
403	permission_error	Du har ikke tilladelse til at rendre dette job	Returneret når den autentificerede bruger ikke ejer det job, der bliver renderet.
404	invalid_request_error	Job ikke fundet	Returneret når det anmodede job ikke eksisterer.
404	invalid_request_error	Bruger ikke fundet	Returneret når den autentificerede brugerrekord ikke kan findes.
429	rate_limit_error	For mange anmodninger	Returneret når klienten overskrider den tilladte anmodningsrate for endpointet. Den nuværende grænse er 60 anmodninger per minut. Ratebegrænsning anvendes primært pr. API-nøgle ved hjælp af x-api-key headeren og falder tilbage til klientens IP-adresse, når en API-nøgle ikke er til stede. Klienter, der rammer denne grænse, bør reducere anmodningsfrekvensen og prøve igen efter at rategrænsen er nulstillet.
500	api_error	Autentificeringsfejl	Returneret når API-nøgleautentificering mislykkes uventet på serveren.
500	api_error	Intern serverfejl	Returneret for uventede server-side fejl i status, rendering eller highlight reel endpoints.
500	server_error	Kunne ikke generere upload URL	Returneret når serveren ikke kan generere en signerede upload URL.