Virheet

VIDIO API käyttää johdonmukaista virheobjektin formaattia. Käytä tätä sivua ymmärtääksesi tavallisia virhetyyppejä, HTTP-tilakoodeja ja esimerkkiviestejä, joita API palauttaa.

API-käyttö on tällä hetkellä saatavilla vain Enterprise-suunnitelmille. Pyydä pääsyä täältä, jos et ole Enterprise-käyttäjä mutta olet kiinnostunut API:sta.

Yleiskatsaus

Kun pyyntö epäonnistuu, VIDIO API palauttaa error-objektin, jossa on type ja message. Jotkut virheet voivat myös sisältää lisäkenttiä, jotka auttavat selittämään epäonnistumisen.

Virheformaatti

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Työtä ei löytynyt"
  }
}

Virheviite

Status	Type	Message	Description
400	invalid_request_error	Puuttuvat vaaditut kyselyparametrit lataus-URL-pyynnössä	Palautetaan, kun vaaditut kyselyparametrit puuttuvat lataus-URL-pyynnöstä.
400	invalid_request_error	Puuttuu job_id	Palautetaan, kun renderöintipyyntö ei sisällä työ-ID:tä.
400	invalid_request_error	Ei tuloksia saatavilla tälle työlle	Palautetaan, kun työllä ei ole mitään renderöitävissä olevia tuloksia.
400	invalid_request_error	input_keys on oltava ei-tyhjällä taulukolla	Palautetaan, kun `input_keys` puuttuu tai on tyhjällä.
400	invalid_request_error	input_keys on oltava vähintään yksi voimassa oleva syötteen avain	Palautetaan, kun kaikki annetut syötteet ovat tyhjät tai virheelliset normalisoinnin jälkeen.
400	invalid_request_error	Virheellinen video_kategoria. Sallittuja arvoja: podcast, pallo-urheilu, ei-pallo-urheilu, kauneustuote-demo, häät, matkustus, muut	Palautetaan, kun `video_category` ei ole tuettu.
400	invalid_request_error	Virheellinen aspect_ratio. Sallittuja arvoja: neliö, muotokuva, maisema	Palautetaan, kun `aspect_ratio` ei ole tuettu.
400	invalid_request_error	output_length on oltava positiivinen luku	Palautetaan, kun `output_length` puuttuu, on nolla tai negatiivinen.
400	invalid_request_error	Ei voitu määrittää positiivista syötteen kestoa input_keys metadatasta	Palautetaan, kun API ei voi määrittää voimassa olevaa kestoa ladatuista syötteistä.
401	authentication_error	Puuttuu API-avain	Palautetaan, kun `x-api-key`-otsikkoa ei ole annettu.
401	authentication_error	Virheellinen API-avain	Palautetaan, kun annettu API-avain ei vastaa aktiivista avainta.
402	insufficient_balance	Sinulla ei ole riittävästi krediittejä tämän työn käsittelyyn	Palautetaan, kun tilillä ei ole riittävästi krediittejä käsittelyyn tai renderöintiä varten.
403	permission_error	Sinulla ei ole oikeutta käyttää tätä työtä	Palautetaan, kun todennettu käyttäjä ei omista pyydettyä työtä.
403	permission_error	Sinulla ei ole oikeutta renderöidä tätä työtä	Palautetaan, kun todennettu käyttäjä ei omista renderöitävää työtä.
404	invalid_request_error	Työtä ei löytynyt	Palautetaan, kun pyydettyä työtä ei ole olemassa.
404	invalid_request_error	Käyttäjää ei löytynyt	Palautetaan, kun todennettavaa käyttäjärekisteriä ei voida löytää.
429	rate_limit_error	Liian monta pyyntöä	Palautetaan, kun asiakas ylittää sallitun pyyntösuhteen päätepisteessä. Nykyinen raja on 60 pyyntöä minuutissa. Rajoittaminen tapahtuu pääasiassa per API-avain käyttäen x-api-key -otsikkoa ja palautuu asiak IP-osoitteeseen, kun API-avainta ei ole olemassa. Asiakkaiden, jotka saavuttavat tämän rajan, tulisi vähentää pyyntötiheyttä ja yrittää uudelleen rajan palautusikkunan jälkeen.
500	api_error	Todennusvirhe	Palautetaan, kun API-avaimen todennus epäonnistuu odottamattomasti palvelimella.
500	api_error	Sisäinen palvelinvirhe	Palautetaan odottamattomista palvelinpuolen epäonnistumisista tilassa, renderöinnissä tai kohokohtareeli päätepisteissä.
500	server_error	Lataus-URL:n luonti epäonnistui	Palautetaan, kun palvelin epäonnistuu luomaan allekirjoitettua lataus-URL:ia.