Feil

VIDIO API bruker et konsistent feils objektformat. Bruk denne siden for å forstå vanlige feiltyper, HTTP-statuskoder og eksempelmeldinger som returneres av API-en.

API-tilgang er for tiden tilgjengelig for bedriftsplaner bare. Be om tilgang her hvis du ikke er en bedriftsbruker, men er interessert i å bruke API-en.

Oversikt

Når en forespørsel mislykkes, returnerer VIDIO API et feil objekt med en type og melding. Noen feil kan også inkludere ytterligere felt for å hjelpe med å forklare feilen.

Feilformat

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Jobb ikke funnet"
  }
}

Feilreferanse

Status	Type	Message	Description
400	invalid_request_error	Mangler nødvendige spørringsparametere i opplastings-URL-forespørselen	Returnert når nødvendige spørringsparametere mangler fra opplastings-URL-forespørselen.
400	invalid_request_error	Mangler job_id	Returnert når renderforespørselen ikke inkluderer et job ID.
400	invalid_request_error	Ingen utdata tilgjengelig for denne jobben	Returnert når jobben ikke har noen renderbare utdata.
400	invalid_request_error	input_keys må være et ikke-tomt array	Returnert når `input_keys` mangler eller er tom.
400	invalid_request_error	input_keys må inneholde minst én gyldig input-nøkkel	Returnert når alle oppgitte input-nøkler er blanke eller ugyldige etter normalisering.
400	invalid_request_error	Ugyldig video_category. Tillatte verdier: podcast, ball-sporter, ikke-ball-sporter, skjønnhetsprodukt-demo, bryllup, reise, andre	Returnert når `video_category` ikke støttes.
400	invalid_request_error	Ugyldig aspekt_ratio. Tillatte verdier: firkantet, portrett, landskap	Returnert når `aspect_ratio` ikke støttes.
400	invalid_request_error	output_length må være et positivt tall	Returnert når `output_length` mangler, er null eller negativ.
400	invalid_request_error	Kunne ikke bestemme positiv inndata varighet fra input_keys metadata	Returnert når API-en ikke kan bestemme en gyldig varighet for de opplastede inndataene.
401	authentication_error	Mangler API-nøkkel	Returnert når `x-api-key` headeren ikke er oppgitt.
401	authentication_error	Ugyldig API-nøkkel	Returnert når den oppgitte API-nøkkelen ikke samsvarer med en aktiv nøkkel.
402	insufficient_balance	Du har ikke nok kreditter til å behandle denne jobben	Returnert når kontoen ikke har nok kreditter for behandling eller rendering.
403	permission_error	Du har ikke tillatelse til å få tilgang til denne jobben	Returnert når den autentiserte brukeren ikke eier den forespurte jobben.
403	permission_error	Du har ikke tillatelse til å rendre denne jobben	Returnert når den autentiserte brukeren ikke eier jobben som blir rendret.
404	invalid_request_error	Jobb ikke funnet	Returnert når den forespurte jobben ikke eksisterer.
404	invalid_request_error	Bruker ikke funnet	Returnert når den autentiserte brukerens post ikke kan bli funnet.
429	rate_limit_error	For mange forespørseler	Returnert når klienten overskrider den tillatte forespørselshastigheten for endepunktet. Den nåværende grensen er 60 forespørseler per minutt. Hastighetsbegrensning påføres først og fremst per API-nøkkel ved å bruke x-api-key headeren, og faller tilbake til klientens IP-adresse når en API-nøkkel ikke er til stede. Klienter som når denne grensen bør redusere forespørselshyppigheten og prøve på nytt etter at hastighetsbegrensningsvinduet tilbakestilles.
500	api_error	Autentisering feil	Returnert når API-nøkkelautentisering feiler uventet på serveren.
500	api_error	Intern serverfeil	Returnert for uventede server-side feil i status, rendering eller høydepunkt waypoints.
500	server_error	Kunne ikke generere opplastings-URL	Returnert når serveren feiler å generere en signert opplastings-URL.