Обзор API Yes Ai для нейросети Апскейла видеороликов
Используя API нейросети апскейл видео, предлагаемый Yes Ai, вы можете масштабировать видео размером до 50 мегабайт и максимальной продолжительностью 5 минут, улучшая их качество, детализацию и размеры. В ближайшее время мы планируем ввести поддержку более крупных и длинных видеороликов, а обновления будут публиковаться на нашем официальном канале Telegram @yes_ai_official
API предоставляет несколько вариантов увеличения разрешения видео:
- HD
- Full HD
- 4К
После завершения процесса вы получите прямую ссылку для загрузки полученного файла MP4.
Для доступа к API вам понадобится токен API. Инструкцию по его приобретению вы можете найти здесь.
Прежде чем интегрировать Yes Ai API для улучшения видео в свои приложения, мы предлагаем опробовать эту нейронную сеть с помощью нашего Telegram-бота @yes_ai_bot
Как сделать Апскейл видео с помощью API в Yes Ai
POST https://api.yesai.su/v2/yesvideo/anivideo/upscale
headers: { Content-Type: application/json, Authorization: Bearer }
Пример запроса API для подачи задания апскейл видео в нейросети Yes Ai
Параметры:
video_url = '' (обязательно, URL оригинального видео)
resolution = '4k'(обязательно, варианты включают: 'hd', 'fhd', '4k', разрешение видео)
Возможные ошибки список:
['success' => false, 'message' => 'VIDEO_URL_IS_EMPTY'], 400
['success' => false, 'message' => 'VIDEO_URL_NOT_VALID'], 400
['success' => false, 'message' => 'RESOLUTION_IS_EMPTY'], 400
['success' => false, 'message' => 'RESOLUTION_NOT_VALID'], 400
['success' => false, 'message' => 'VIDEO_FILE_SIZE_NOT_VALID'], 400
['success' => false, 'message' => 'VIDEO_MIME_TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'VIDEO_NOT_FOUND'], 404
['success' => false, 'message' => 'USER_HAS_BEEN_BANNED'], 409
['success' => false, 'message' => 'USER_HAS_BEEN_DELETED'], 409
['success' => false, 'message' => 'NOT_ENOUGH_RPOINTS'], 409
['success' => false, 'message' => 'TASK_LIMIT_EXCEEDED'], 409
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500
Ответ при успешной подаче нового задания через API Yes Ai:
['success' => true, 'message' => 'OK', 'results' => ['animation_data' => [ ... ]]], 200
Инструкция по проверке выполнения задания по его iD через API Yes Ai
GET https://api.yesai.su/v2/yesvideo/animations/{id}
headers: { Content-Type: application/json, Authorization: Bearer }
Пример запроса API для подачи задания апскейл видео в нейросети Yes Ai
Параметры:
{id} = 12345 (обязательно, id задания)
Возможные ошибки список:
['success' => false, 'message' => 'ID_IS_EMPTY'], 400
['success' => false, 'message' => 'ID_NOT_VALID'], 400
['success' => false, 'message' => 'ID_NOT_FOUND'], 404
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500
Ответ при успешной проверке статуса выполнения задания через API Yes Ai:
['success' => true, 'message' => 'OK', 'results' => ['animation_data' => [ ... ]]], 200
Возможные коды статусов:
- "status": 0 ("status_description":"in queue") - задача в данный момент ожидает в очереди;
- "status": 1 ("status_description":"in progress") - задача принята к выполнению (нужно подождать);
- "status": 2 ("status_description":"completed") - задача успешно завершена (теперь можно приступать к обработке результатов);
- "status": 3 ("status_description":"rejected with error") - задание отклонено из-за ошибки (причину можно узнать в разделах comment_ru" и "comment_en");
- "status": 4 ("status_description":"rejected due to timeout") - задача отклонена по причине истечения времени ожидания (вам нужно будет отправить задачу еще раз).
Ответа API в формате JSON при проверке статуса выполнения заказов
Обзор параметров, найденных в ответе API Yes Ai при выполнении задачи по апскейлу видео:
После успешного завершения задачи по масштабированию вам будет предоставлена специальная ссылка для скачивания видео в формате MP4. Данное видео будет доступно на нашем сервере продолжительностью 60 минут.
Как только вы выполнили задание, важно загрузить результат на собственный сервер.
Ограничения на отправку и мониторинг статусов задач
В Yes Ai вы можете создавать задания с помощью API и отслеживать их статусы на основе указанных рекомендаций.
При подаче новых заданий должны соблюдаться следующие требования к видео:
- Максимальный размер файла для апскейл - 50 мегабайт
- Максимальная продолжительность видео - 5 минут
- Единственный поддерживаемый формат видео — mp4.
Чтобы создавать новые задания через API, вам следует отправлять POST-запросы, следя за тем, чтобы вы не отправляли задачи чаще, чем раз в секунду.
Очередь Yes Ai, которая используется всеми типами заданий, отправленных через API, может одновременно содержать до 8 задач.
Если ваш сервис генерирует задания чаще, вам потребуется реализовать собственную очередь заданий.
Для проверки статусов выполнения ранее отправленных задач вы можете отправлять GET-запросы, но не забудьте ограничить проверки статуса один раз в секунду.
По всем вопросам использования Yes Ai API обращайтесь в официальную службу технической поддержки через мессенджер Telegram по адресу @yes_ai_support