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 tilgængelig for Studio-planen og opad.

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	Manglende nødvendige forespørgselsparametre i anmodningen om upload-URL	Returneres når påkrævede forespørgselsparametre mangler i anmodningen om upload-URL.
400	invalid_request_error	Manglende job_id	Returneres når gengivelsesanmodningen ikke inkluderer et job-id.
400	invalid_request_error	Ingen outputs tilgængelige for dette job	Returneres når jobbet ikke har nogen output, der kan gengives.
400	invalid_request_error	input_keys skal være et ikke-tomt array	Returneres når `input_keys` mangler eller er tom.
400	invalid_request_error	input_keys skal indeholde mindst én gyldig input-nøgle	Returneres når alle angivne inputnøgler er tomme eller ugyldige efter normalisering.
400	input_duration_requirement_error	Den samlede inputvarighed skal være større end 2 sekunder	Returneres når den samlede varighed af alt inputmedie er 2 sekunder eller mindre.
400	input_duration_requirement_error	Den samlede inputvarighed skal være mindre end 6 timer	Returneres når den samlede varighed af alt inputmedie er 6 timer eller mere.
400	input_image_count_requirement_error	Antal inputbilleder må højst være 4000	Returneres når antallet af inputbilleder overskrider den maksimalt tilladte grænse på 4000.
400	input_video_count_requirement_error	Antal inputvideoer må højst være 400	Returneres når antallet af inputvideoer overskrider den maksimalt tilladte grænse på 400.
400	invalid_request_error	Ugyldig video_category. Allowed values: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Returneres når `video_category` ikke understøttes.
400	invalid_request_error	Ugyldig aspect_ratio. Allowed values: square, portrait, landscape	Returneres når `aspect_ratio` ikke understøttes.
400	invalid_request_error	output_length skal være et positivt tal	Returneres når `output_length` mangler, er nul eller negativ.
400	invalid_request_error	Kunne ikke bestemme positiv inputvarighed fra input_keys-metadata	Returneres når API'en ikke kan bestemme en gyldig varighed for de uploadede input.
400	invalid_request_error	music_volume skal være et tal mellem 0 og 100	Returneres når `music_volume` angives, men ikke er et gyldigt tal mellem 0 og 100.
400	invalid_request_error	original_audio_volume skal være et tal mellem 0 og 100	Returneres når `original_audio_volume` angives, men ikke er et gyldigt tal mellem 0 og 100.
400	invalid_request_error	Ugyldig music_category. Allowed values: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Returneres når `music_category` angives, men ikke matcher en af de understøttede musik-kategorier.
401	authentication_error	Manglende API-nøgle	Returneres når `x-api-key` headeren ikke er angivet.
401	authentication_error	Ugyldig API-nøgle	Returneres når den angivne API-nøgle ikke matcher en aktiv nøgle.
402	insufficient_balance	Du har ikke nok kreditter til at behandle dette job	Returneres når kontoen ikke har nok kreditter til behandling eller gengivelse.
403	permission_error	Du har ikke tilladelse til at få adgang til dette job	Returneres når den godkendte bruger ikke ejer det forespurgte job.
403	permission_error	Du har ikke tilladelse til at gengive dette job	Returneres når den godkendte bruger ikke ejer det job, der gengives.
404	invalid_request_error	Job ikke fundet	Returneres når det forespurgte job ikke findes.
404	invalid_request_error	Bruger ikke fundet	Returneres når den autentificerede brugerpost ikke kan findes.
429	rate_limit_error	For mange forespørgsler	Returneres når klienten overskrider den tilladte forespørgselsrate for endpointet. Den nuværende grænse er 60 forespørgsler per minut. Ratebegrænsning anvendes primært per 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 forespørgselsfrekvensen og prøve igen, efter at ratebegrænsningsvinduet er nulstillet.
429	rate_limit_error	Du har allerede 10 kørende eller ventende jobs, hvilket er den maksimalt tilladte. Vent venligst på, at nogle job afsluttes, før du indsender et nyt.	Returneres når brugeren allerede har det maksimalt tilladte antal igangværende job, både kørende jobs på servere og ventende jobs i køen. Den nuværende grænse er 10 i alt kørende eller ventende jobs per bruger. Ejerskab bestemmes ved at matche hvert job_id på optagede servere og ventende køposter tilbage til jobbets user_email. Klienter, der rammer denne grænse, bør vente på, at et eller flere eksisterende job afsluttes, før de opretter eller gengiver et nyt job.
500	api_error	Autentificeringsfejl	Returneres når API-nøgleautentificering fejler uventet på serveren.
500	api_error	Intern serverfejl	Returneres ved uventede serverfejl i status-, render- eller highlight-reel-endpoints.
500	server_error	Kunne ikke generere upload-URL	Returneres når serveren ikke kan generere en signeret upload-URL.