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 Studio-plan og høyere.

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 påkrevde spørringsparametere i forespørsel om opplastings-URL	Returneres når påkrevde spørringsparametre mangler i forespørselen om opplastings-URL.
400	invalid_request_error	Mangler job_id	Returneres når render-forespørselen ikke inkluderer en jobb-ID.
400	invalid_request_error	Ingen utdata tilgjengelig for denne jobben	Returneres når jobben ikke har noen utdata som kan renderes.
400	invalid_request_error	input_keys må være et ikke-tomt array	Returneres når `input_keys` mangler eller er tom.
400	invalid_request_error	input_keys må inneholde minst én gyldig inputnøkkel	Returneres når alle oppgitte inputnøkler er tomme eller ugyldige etter normalisering.
400	input_duration_requirement_error	Total inputvarighet må være større enn 2 sekunder	Returneres når den samlede varigheten av alt inputmedia er 2 sekunder eller mindre.
400	input_duration_requirement_error	Total inputvarighet må være mindre enn 6 timer	Returneres når den samlede varigheten av alt inputmedia er 6 timer eller mer.
400	input_image_count_requirement_error	Antall inputbilder kan ikke overstige 4000	Returneres når antallet inputbilder overstiger maksimumsgrensen på 4000.
400	input_video_count_requirement_error	Antall inputvideoer kan ikke overstige 400	Returneres når antallet inputvideoer overstiger maksimumsgrensen på 400.
400	invalid_request_error	Ugyldig video_category. Tillatte verdier: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Returneres når `video_category` ikke støttes.
400	invalid_request_error	Ugyldig aspect_ratio. Tillatte verdier: square, portrait, landscape	Returneres når `aspect_ratio` ikke støttes.
400	invalid_request_error	output_length må være et positivt tall	Returneres når `output_length` mangler, er null eller negativ.
400	invalid_request_error	Kunne ikke fastslå positiv inputvarighet fra input_keys-metadata	Returneres når API-et ikke kan bestemme en gyldig varighet for de opplastede inputene.
400	invalid_request_error	music_volume må være et tall mellom 0 og 100	Returneres når `music_volume` er oppgitt, men ikke er et gyldig tall mellom 0 og 100.
400	invalid_request_error	original_audio_volume må være et tall mellom 0 og 100	Returneres når `original_audio_volume` er oppgitt, men ikke er et gyldig tall mellom 0 og 100.
400	invalid_request_error	Ugyldig music_category. Tillatte verdier: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Returneres når `music_category` er oppgitt, men ikke stemmer overens med en av de støttede musikkategoriene.
401	authentication_error	Manglende API-nøkkel	Returneres når `x-api-key`-headeren ikke er angitt.
401	authentication_error	Ugyldig API-nøkkel	Returneres 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	Returneres når kontoen ikke har nok kreditter for behandling eller rendering.
403	permission_error	Du har ikke tillatelse til å få tilgang til denne jobben	Returneres når den autentiserte brukeren ikke eier den forespurte jobben.
403	permission_error	Du har ikke tillatelse til å rendre denne jobben	Returneres når den autentiserte brukeren ikke eier jobben som skal rendres.
404	invalid_request_error	Jobb ikke funnet	Returneres når den forespurte jobben ikke finnes.
404	invalid_request_error	Bruker ikke funnet	Returneres når den autentiserte brukerens post ikke kan finnes.
429	rate_limit_error	For mange forespørsler	Returneres når klienten overskrider tillatt forespørselsrate for endepunktet. Den nåværende grensen er 60 forespørsler per minutt. Ratebegrensning blir primært anvendt per API-nøkkel ved bruk av `x-api-key`-headeren, og faller tilbake til klientens IP-adresse når en API-nøkkel ikke er til stede. Klienter som treffer denne grensen bør redusere forespørselsfrekvensen og prøve igjen etter at ratebegrensningsvinduet tilbakestilles.
429	rate_limit_error	Du har allerede 10 kjørende eller i kø-stående jobber, som er maks tillatt. Vennligst vent til noen jobber er fullført før du sender inn en ny.	Returneres når brukeren allerede har maks tillatt antall pågående jobber, både kjørende jobber på servere og ventende jobber i køen. Gjeldende grense er 10 totale kjørende eller kø-stående jobber per bruker. Eierforhold bestemmes ved å matche hver job_id på opptatte servere og ventende køoppføringer tilbake til jobbens user_email. Klienter som treffer denne grensen bør vente til en eller flere eksisterende jobber er fullført før de oppretter eller rendrer en ny jobb.
500	api_error	Autentiseringsfeil	Returneres når API-nøkkelautentisering feiler uventet på serveren.
500	api_error	Intern serverfeil	Returneres for uventede serverfeil i status-, render- eller highlight-reel-endepunkter.
500	server_error	Kunne ikke generere opplastings-URL	Returneres når serveren ikke klarer å generere en signert opplastings-URL.