Грешки

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

Достъпът до API в момента е наличен за план Studio и по-висок.

Общ преглед

Когато заявката не успее, 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	Връща се, когато заявката за рендиране не включва job ID.
400	invalid_request_error	Няма налични резултати за тази задача	Връща се, когато задачата няма никакви изходи за рендиране.
400	invalid_request_error	input_keys трябва да е непразен масив	Връща се, когато `input_keys` липсва или е празен.
400	invalid_request_error	input_keys трябва да съдържа поне един валиден входен ключ	Връща се, когато всички предоставени входни ключове са празни или невалидни след нормализация.
400	input_duration_requirement_error	Общата продължителност на входните файлове трябва да е повече от 2 секунди	Връща се, когато комбинираната продължителност на всички входни медии е 2 секунди или по-малко.
400	input_duration_requirement_error	Общата продължителност на входните файлове трябва да е по-малко от 6 часа	Връща се, когато комбинираната продължителност на всички входни медии е 6 часа или повече.
400	input_image_count_requirement_error	Броят входни изображения не трябва да надвишава 4000	Връща се, когато броят входни изображения надвишава максимално разрешения лимит от 4000.
400	input_video_count_requirement_error	Броят входни видеа не трябва да надвишава 400	Връща се, когато броят входни видеа надвишава максимално разрешения лимит от 400.
400	invalid_request_error	Невалиден video_category. Разрешени стойности: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Връща се, когато `video_category` не се поддържа.
400	invalid_request_error	Невалиден aspect_ratio. Разрешени стойности: square, portrait, landscape	Връща се, когато `aspect_ratio` не се поддържа.
400	invalid_request_error	output_length трябва да бъде положително число	Връща се, когато `output_length` липсва, е нула или е отрицателно.
400	invalid_request_error	Не може да се определи положителна продължителност на входа от метаданните на input_keys	Връща се, когато API не може да определи валидна продължителност за качените входни файлове.
400	invalid_request_error	music_volume трябва да е число между 0 и 100	Връща се, когато `music_volume` е предоставен, но не е валидно число между 0 и 100.
400	invalid_request_error	original_audio_volume трябва да е число между 0 и 100	Връща се, когато `original_audio_volume` е предоставен, но не е валидно число между 0 и 100.
400	invalid_request_error	Невалиден music_category. Разрешени стойности: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Връща се, когато е предоставен `music_category`, но той не съвпада с някоя от поддържаните музикални категории.
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 адресът на клиента. Клиентите, които достигнат този лимит, трябва да намалят честотата на заявките и да опитат отново след като прозорецът за ограничаване на честотата се нулира.
429	rate_limit_error	Вече имате 10 текущи или поставени в опашка задачи, което е максимално позволено. Моля, изчакайте някои задачи да завършат, преди да подадете друга.	Връща се, когато потребителят вече има максимално разрешения брой задачи в процес на изпълнение — както текущо изпълнявани на сървърите, така и чакащи в опашката. Текущият лимит е 10 задачи общо (текущи или в опашка) на потребител. Собствеността се определя чрез съпоставяне на всеки job_id за заетите сървъри и записите в опашката с user_email на задачата. Клиентите, които ударят този лимит, трябва да изчакат една или повече съществуващи задачи да завършат, преди да създадат или рендират друга задача.
500	api_error	Грешка при удостоверяване	Връща се, когато удостоверяването с API ключ не успее неочаквано на сървъра.
500	api_error	Вътрешна грешка на сървъра	Връща се при неочаквани грешки от страна на сървъра в крайни точки за статус, рендиране или highlight reel.
500	server_error	Неуспешно генериране на URL за качване	Връща се, когато сървърът не успее да генерира подписан URL за качване.