Грешки

VIDIO API използва последователен формат на обекти за грешки. Използвайте тази страница, за да разберете общите типове грешки, HTTP статус кодове и примерни съобщения, върнати от API.

Достъпът до API в момента е наличен само за Enterprise планове. Искате ли достъп тук, ако не сте потребител на Enterprise, но сте заинтересовани от използването на API.

Общ преглед

Когато заявката не успее, VIDIO API връща обект error с type и message. Някои грешки може да включват и допълнителни полета, за да помогнат да се обясни провала.

Формат на грешка

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Работа не е намерена"
  }
}

Референция на грешки

Status	Type	Message	Description
400	invalid_request_error	Липсват задължителни параметри в заявката за качване на URL	Върнато, когато липсват задължителни параметри от заявката за качване на URL.
400	invalid_request_error	Липсва job_id	Върнато, когато заявката за рендер не включва ID на работа.
400	invalid_request_error	Няма налични изходи за тази работа	Върнато, когато работата няма налични рендерируеми изходи.
400	invalid_request_error	input_keys трябва да е непразен масив	Върнато, когато `input_keys` липсва или е празен.
400	invalid_request_error	input_keys трябва да съдържа поне един валиден входящ ключ	Върнато, когато всички предоставени входящи ключове са празни или невалидни след нормализация.
400	invalid_request_error	Невалидна видео категория. Позволени стойности: подкаст, спорт с топка, спорт без топка, демонстрация на козметичен продукт, сватба, пътуване, други	Върнато, когато `video_category` не се поддържа.
400	invalid_request_error	Невалидно съотношение на страните. Позволени стойности: квадрат, портрет, пейзаж	Върнато, когато `aspect_ratio` не се поддържа.
400	invalid_request_error	output_length трябва да е положително число	Върнато, когато `output_length` липсва, е нула или отрицателно.
400	invalid_request_error	Не можа да се определи положителната входяща продължителност от метаданните на input_keys	Върнато, когато API не може да определи валидна продължителност за качените входове.
401	authentication_error	Липсва API ключ	Върнато, когато заглавието `x-api-key` не е предоставено.
401	authentication_error	Невалиден API ключ	Върнато, когато предоставеният API ключ не съвпада с активен ключ.
402	insufficient_balance	Нямате достатъчно кредити за обработка на тази работа	Върнато, когато акаунтът няма достатъчно кредити за обработка или рендериране.
403	permission_error	Нямате разрешение да получите достъп до тази работа	Върнато, когато удостовереният потребител не притежава исканата работа.
403	permission_error	Нямате разрешение да рендерирате тази работа	Върнато, когато удостовереният потребител не притежава работата, която се рендерира.
404	invalid_request_error	Работа не е намерена	Върнато, когато исканата работа не съществува.
404	invalid_request_error	Потребител не е намерен	Върнато, когато записа на удостоверения потребител не може да бъде намерен.
429	rate_limit_error	Прекалено много заявки	Върнато, когато клиентът превиши разрешената скорост на заявки за ендпойнта. Текущият лимит е 60 заявки на минута. Ограничаването на скоростта основно се прилага на база API ключ, използвайки заглавието x-api-key, и преминава на IP адреса на клиента, когато API ключ не е наличен. Клиентите, които достигат този лимит, трябва да намалят честотата на заявките и да опитат отново след нулиране на периода на ограничаване на скоростта.
500	api_error	Грешка при удостоверяване	Върнато, когато удостоверяването с API ключ неуспешно при сървъра.
500	api_error	Вътрешна сървърна грешка	Върнато за неочаквани провали на сървъра в статус, рендериране или ендпойнт на акценти.
500	server_error	Неуспешно генериране на URL за качване	Върнато, когато сървърът не успее да генерира подписан URL за качване.