Разбор API Yes Ai Sora, нейросеть для генерации видео

API нейросети Sora, которую разработали в Yes Ai, позволяет легко добавлять функции генерации видео в любые приложения, сайты и даже собственные проекты. Ниже мы разберем как подключить апи этой нейросети пошагово.

OpenAI заметно опережает конкурентов: она умеет создавать видеоролики по обычному текстовому описанию. Сервис стремительно развивается — постоянно появляются новые фишки и обновления API. Подписывайтесь на наш Telegram-канал — так вы точно не пропустите свежие новости и важные изменения!

Чтобы отправлять задания в нейросеть Sora и следить за их выполнением, понадобится API-токен — это ваш ключ для авторизации. Как получить токен, описано пошагово здесь.

Сколько будет стоить создание видео, зависит от выбранных параметров. Текущие цены всегда можно узнать через нашего бота. Перед тем как подключать Sora к своему проекту, первым делом проверьте её на тестовых данных. Возникли вопросы? Команда поддержки всегда на связи в Telegram — пишите на @yes_ai_support

Хотите глубже разобраться в возможностях Sora? Все подробности собраны в отдельной статье — советуем заглянуть.

Вот что умеет этот инструмент:

Генерировать ролики по текстовому описанию. Просто формулируете, что хотите получить, — и на выходе видео готово. Никаких исходных картинок не требуется.
Делать видео на основе референсного изображения. Загрузили картинку — получили видео, где она легла в основу генерации.
Совмещать оба метода. Если точность важна — подключаете и текст, и изображение. Sora учитывает всё, чтобы результат максимально соответствовал вашим ожиданиям.
Гибко выбирать длительность. Нужно короткое или чуть длиннее видео? На выбор интервалы от 5 до 20 секунд.
Добавлять эффекты на базе собственных разработок OpenAI. Ваши ролики будут отличаться от масс благодаря уникальным анимациям.
Настраивать разрешение. Поддерживаются три популярных формата: 480p, 720p и 1080p.
Выбирать ориентацию под нужды: горизонтальная, квадратная или вертикальная — на все случаи контента.

Sora отлично подойдет для креативных проектов, маркетинговых задач и социальных сетей. На личном опыте отмечу: сервис сокращает временные затраты и дает результат, который сложно отличить от ручной работы.

POST https://api.yesai.su/v2/yesvideo/aniimage/sora
headers: { Content-Type: application/json, Authorization: Bearer }

API запрос, пример:

curl -X POST https://api.yesai.su/v2/yesvideo/aniimage/sora -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{ "prompt": "котенок прыгает", "image_url": "https://yoururl.com/image1.jpeg", "effect_id": 0, "resolution": 480, "dimensions": "9:16", "duration": 15 }'

Параметры для настройки:

prompt: '' (опционально — используйте для текстового задания, если нет ссылки на изображение)
image_url: '' (опционально — указывайте ссылку на изображение, обязательно, если prompt не указан)
- effect_id: 0 (по умолчанию: 0). Доступные эффекты:
- 0 — Без эффекта
- 1 — Воздушные шары
- 2 — Ручная работа
- 3 — Старая пленка
- 4 — Нуарный стиль
- 5 — Оригами
resolution: 480 (опционально, можно выбрать 480, 720 или 1080)
dimensions: '9:16' (опционально, стандартно 1:1. Есть варианты: 1:1, 9:16, 16:9)
duration: 15 (опционально, по стандарту 5 секунд. Можно ставить 5, 10, 15 или 20 секунд)

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

['success' => false, 'message' => 'IMAGE_URL_IS_EMPTY'], 400
['success' => false, 'message' => 'IMAGE_URL_NOT_VALID'], 400
['success' => false, 'message' => 'IMAGE_FILE_SIZE_NOT_VALID'], 400
['success' => false, 'message' => 'IMAGE_MIME_TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'PROMPT_IS_EMPTY'], 400
['success' => false, 'message' => 'PROMPT_NOT_VALID'], 400
['success' => false, 'message' => 'PROMPT_AND_IMAGE_URL_IS_EMPTY'], 400
['success' => false, 'message' => 'RESOLUTION_IS_EMPTY'], 400
['success' => false, 'message' => 'RESOLUTION_NOT_VALID'], 400
['success' => false, 'message' => 'DIMENSIONS_IS_EMPTY'], 400
['success' => false, 'message' => 'DIMENSIONS_NOT_VALID'], 400
['success' => false, 'message' => 'DURATION_IS_EMPTY'], 400
['success' => false, 'message' => 'DURATION_NOT_VALID'], 400
['success' => false, 'message' => 'EFFECT_ID_IS_EMPTY'], 400
['success' => false, 'message' => 'EFFECT_ID_NOT_VALID'], 400
['success' => false, 'message' => 'SETTINGS_IS_EMPTY'], 400
['success' => false, 'message' => 'SETTINGS_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'IMAGE_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' => 'PROMPT_NSFW_WORDS'], 409
['success' => false, 'message' => 'PARAMETERS_IS_NOT_ALLOWED'], 409
['success' => false, 'message' => 'TASK_LIMIT_EXCEEDED'], 409
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500

Пример ответа при успешной подаче задания в API Sora:

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

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

API запрос, пример:

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

Параметры:

{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

Пример ответа при успешной проверке статуса выполения заказа Sora:

['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 Yes Ai при удачном завершении генерации задачи на нейросети Sora

{ "success": true, // данные успешно получены "message": "OK", "results": { "animation_data": { "id": 15977, // уникальный ID задания в системе Yes Ai "user_id": 1234567890, // ID пользователя, который подал задание "tariff_id": 30, // тарифный план пользователя (0 - Demo, 5 - Micro, 10 - Start, 20 - Standard, 30 - VIP) "type": 23, // тип выполненного задания, 23 - генерация видео в нейросети Sora "styles": [], "settings": { "sora_resolution": 480, "sora_dimensions": "1:1", "sora_duration": 5, "sora_effect_id": 0 }, "child_ids": [], "parent_id": 0, "photo_url": "", "image_url": "https://yourdomain.com/photo1.jpeg", // ссылка с исходным изображением, которое отправил клиент "audio_url": "", "video_url": "", "final_frame_url": "", "result_url": "https://yesai.su/files/yesvideo/animations/1234567890_1734572836727827.mp4", // результат выполнения задания в формате MP4, его необходимо скачать на свой сервер "result_type": "video", "result_data": { "video_fps": 30, // количество кадров в секунду "video_width": 480, // ширина видео в пикселях, которое является результатом выполнения задания "video_height": 480, // высота видео в пикселях, которое является результатом выполнения задания "video_duration": 5, // длительность видео в секундах "video_durrange": 0 }, "comment_ru": "", // комментарий к заданию на русском языке, он заполняется только в том случае, если задание не удалось выполнить "comment_en": "", // комментарий к заданию на английском языке, он заполняется только в том случае, если задание не удалось выполнить "accounting": { "total_cost": 1, // итоговая стоимость выполнения задания в условных единицах "spent_points": 0, // количество ⭐️ баллов, которые были сняты с баланса за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "spent_rpoints": 1, // количество 🔅 монет, которые были сняты с баланса за выполнение задания "spent_repost_points": 0, "spent_balance": 0, // количество денег с основного баланса, которое было снято за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "spent_rbalance": 0, // количество денег с бонусного баланса, которое было снято за выполнение задания. Для Sora поле всегда будет равно 0, т.к. оплата производится в 🔅 монетах "remaining_points": 1820, // остаток средств на балансе ⭐️ баллов после выполнения задания "remaining_rpoints": 3574.3038666, // остаток средств на балансе 🔅 монет после выполнения задания "remaining_repost_points": 0, "remaining_balance": 0, // остаток средств на основном балансе после выполнения задания "remaining_rbalance": 5019.31631 // остаток средств на бонусном балансе после выполнения задания }, "language": "", "prompt": "ваш промт на любом языке", // оригинальный текст промта, отправленного клиентом - не отображается, если не было отправлено при подаче задания "prompt_en": "your prompt", // текст промта на английском языке - система Yes Ai производит автоматический перевод промтов клиентов "status": 2, // статус задания, где 2 - успешное завершение "status_description": "completed", // текстовое пояснение у статусу задания, где completed означает успешное завершение "start_at": 1735095375, // unixtime, время начала выполнения задания "finish_at": 1735095463, // unixtime, время завершения выполнения задания "created_at": 1735095279, // unixtime, время подачи задания клиентом "updated_at": 1735095463 // unixtime, время последнего обновления статуса задания } } }

Когда задание на анимацию картинки успешно завершено, система генерирует индивидуальную ссылку на скачивание видеофайла в формате MP4. Этот файл хранится на сервере ровно 60 минут, так что скачивайте его без промедления — после этого срока доступ будет закрыт.

Рекомендую сразу забирать полученный результат на ваш сервер, чтобы избежать потери данных.

Задания отправляют через API Yes Ai, а их статусы можно отслеживать только по установленным лимитам

Требования к изображениям:

Размер не выше 5 мегабайт
Максимум 2000 пикселей по любой стороне
Поддерживаются форматы: jpg, jpeg, png

Ограничения скорости:

Создавать задания можно не чаще, чем один раз в секунду (POST-запросы).
В общей очереди (на все типы задач) разрешено не более восьми активных заданий. Больше — нужен внутренний буфер или очередь у себя.
Проверять статус выполнения тоже можно только раз в секунду (GET-запросы).

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

По всем вопросам, связанным с работой API, обращайтесь в поддержку в Telegram: @yes_ai_support

Разбор API Yes Ai Sora, нейросеть для генерации видео

API нейросети Sora от Yes Ai открывает перед пользователями совершенно новые горизонты работы с видео.

Инструкция по отправке запроса на генерацию видео в Sora через API

Инструкция по проверке статуса выполнения заказа по Id через API

Пример JSON-ответа API при проверке текущего статуса:

Как устроена обработка видео-заданий через API Yes Ai (генерация c помощью Sora)

Ограничения работы с заданиями через API