Анимация изображений с помощью API Yes Ai - Stable Video Diffusion

Проект Yes Ai предоставляет нейросеть Анимация изображений с помощью API Yes Ai - Stable Video Diffusion. Вы можете использовать наш API для интеграции анимации в ваши существующие проекты, сайты или боты. Мы предоставляем подробную документацию и поддержку для разработчиков, чтобы помочь вам в реализации вашего проекта.

Создание персонализированного приложения или веб-сайта, которое предлагает услуги анимации изображений через наше API, вполне выполнимо. Вам понадобится:

Для того чтобы создать персональный ключ доступа <token> для выполнения запросов, необходимо направить команду /api боту @yes_ai_bot в мессенджере Telegram, после чего он будет сгенерирован.

ОБРАТИТЕ ВНИМАНИЕ ‼ Строго воспрещается использование сервисов Yes Ai в целях, противоречащих закону. Рекомендуется также производить отсев задач на вашей стороне, чтобы исключить возможность неправомерных действий со стороны ваших пользователей.

ОБРАТИТЕ ВНИМАНИЕ ‼ Недопустима передача личных ключей доступа к API третьим лицам, поскольку это может привести к их использованию злоумышленниками для осуществления операций с ресурсами вашего аккаунта в Yes Ai. Пожалуйста, учтите, что возврат средств, потраченных без вашего согласия, не производится.

За выполненные задания, отправленные через API, оплата всегда происходит за счет 🔆 монет, а не ⭐ баллов. Рекомендуем пополнить счет в @yes_ai_bot перед началом тестирования.

Прежде чем приступить к интеграции API и созданию собственных проектов, настоятельно советуем протестировать сервис с помощью нашего бота в Telegram @yes_ai_bot, чтобы убедиться в его соответствии вашим требованиям.

POST https://api.yesai.su/v2/yesvideo/aniphoto/svd
headers: { Content-Type: application/json, Authorization: Bearer <token> }

Образец заявки на создание анимации Stable Video Diffusion:

Параметры:

photo_url = '...' (ссылка на фото, обязательно)

Список возможных ошибок:

['success' => false, 'message' => 'PHOTO_URL_IS_EMPTY'], 400
['success' => false, 'message' => 'PHOTO_URL_NOT_VALID'], 400
['success' => false, 'message' => 'PHOTO_FILE_SIZE_NOT_VALID'], 400
['success' => false, 'message' => 'PHOTO_MIME_TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'PHOTO_NOT_FOUND'], 404
['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

Формат ответа при успешной подаче нового задания:

['success' => true, 'message' => 'OK', 'results' => ['animation_data' => [ ... ]]], 200

Как только ваше задание будет успешно принято, вам будет предоставлен специальный идентификационный номер "id". Этот номер будет необходим для последующего отслеживания статуса выполнения вашего запроса. Пожалуйста, сохраните этот номер в надежном месте.
В случае возникновения вопросов или проблем, вы сможете обратиться в службу поддержки (@yes_ai_support), предоставив ваш уникальный идентификационный номер. Мы постараемся решить вашу проблему в кратчайшие сроки.

GET https://api.yesai.su/v2/yesvideo/animations/{id}
headers: { Content-Type: application/json, Authorization: Bearer <token> }

Образец запроса на получение информации о состоянии выполнения конкретного задания Stable Video Diffusion:

Параметры:

{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

Формат ответа при успешной подаче нового задания:

['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") - задание отклонено по таймауту (следует подать задание повторно)

Данный подход к мониторингу задач является идеальным для ситуаций, когда задачи классифицируются группами, в отличие от индивидуального учета. В ответ на запрос, система предоставит вам список из 20 последних задач, отсортированных в соответствии со статусом, который вы выбрали.

В случае, когда фильтр по статусу не применяется в запросе, то эндпойнт вернет перечень из 20 последних задач, не сортированных по статусу.

GET https://api.yesai.su/v2/yesvideo/animations?type=4&status={status}
headers: { Content-Type: application/json, Authorization: Bearer <token> }

Образец запроса на получение информации о состоянии выполнения последних заданий Stable Video Diffusion:

Параметры:

{status} = 2 (обязательно, статус заданий. Допускается перечисление нескольких типов статусов в одном запросе через запятую, например: status=1,2,3)
{type} = 4 (обязательно, тип услуги Stable Video Diffusion)

Параметр {status} может принимать следующие значения:

0 - список заданий, которые находятся в очереди на выполнение
1 - список заданий, которые уже выполняются
2 - список заданий, которые уже выполнены
3 - список заданий, которые отклонены системой
4 - список заданий, которые отклонены по таймауту

Возможные ошибки:

['success' => false, 'message' => 'TYPE_IS_EMPTY'], 400
['success' => false, 'message' => 'TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'TYPES_NOT_VALID'], 400
['success' => false, 'message' => 'STATUS_IS_EMPTY'], 400
['success' => false, 'message' => 'STATUS_NOT_VALID'], 400
['success' => false, 'message' => 'LIMIT_OFFSET_IS_EMPTY'], 400
['success' => false, 'message' => 'LIMIT_OFFSET_NOT_VALID'], 400
['success' => false, 'message' => 'LIMIT_COUNT_IS_EMPTY'], 400
['success' => false, 'message' => 'LIMIT_COUNT_NOT_VALID'], 400
['success' => false, 'message' => 'SORT_FIELD_IS_EMPTY'], 400
['success' => false, 'message' => 'SORT_FIELD_NOT_VALID'], 400
['success' => false, 'message' => 'SORT_ORDER_IS_EMPTY'], 400
['success' => false, 'message' => 'SORT_ORDER_NOT_VALID'], 400
['success' => false, 'message' => 'DATA_TYPE_IS_EMPTY'], 400
['success' => false, 'message' => 'DATA_TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'ID_OFFSET_IS_EMPTY'], 400
['success' => false, 'message' => 'ID_OFFSET_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500

Пример:

В случае, если задача по анимации изображений будет выполнена корректно, вам будет предоставлена эксклюзивная ссылка для загрузки видеоролика в формате "MP4". Данный файл будет доступен на нашем сервере в течение одного часа.
Рекомендуем незамедлительно произвести загрузку результата работы на ваш сервер.

В Yes Ai через API предоставляется пользователям отслеживание текущего состояния заданий.

Критерии для изображений, предоставляемых в рамках подачи новых заданий:

Отправка запросов POST для создания новых заданий через API:

В случае увеличения частоты создания заданий в вашем сервисе, целесообразно управлять ими, организовав собственный порядок очереди.

Лимит очереди для заданий в Yes Ai (при этом учтите, что данная очередь является совместной для всех видов заданий, которые подаются через API Yes Ai):

Для запроса информации о состоянии заданий, которые были отправлены ранее, следует использовать GET запросы с определенной регулярностью:

Примеры анимаций изображений с помощью API Yes Ai можете посмотреть в нашем сообществе в телеграм: