Обзор API Veo 3, нейросети для генерации видео роликов

Veo 3 API — инновационная нейросеть, способная создавать видеоролики на основе текстовых запросов или примеров, а также озвучивать диалоги и добавлять звуки окружающей среды, включая поддержку русского языка. Благодаря нашему API (программному интерфейсу), вы легко интегрируете все функциональные возможности Veo 3 в ваш сайт, мобильное приложение или чат-бот, расширяя потенциал вашего проекта.

возможность создавать ролики продолжительностью до 8 секунд;
функция озвучивания героев по написанному сценарию (в тестовом режиме);
опция использовать картинки в качестве исходных референсов;
минимальный риск появления ошибок и неправильных интерпретаций.

Перед тем как подключить нейросеть Veo 3 к вашему проекту через API, советуем сначала внимательно изучить пошаговую инструкцию. Кроме того, вы можете опробовать функционал нейросети в нашем Telegram-боте, чтобы познакомиться с её возможностями на практике.

Отметим: система поддерживает диалоговый режим. Это означает, что внутри промта текст, предназначенный для воспроизведения разными персонажами, необходимо заключать в кавычки. При этом не забывайте корректно экранировать кавычки согласно требованиям оформления JSON-файлов.

API Veo 3 от компании Yes Ai — это современное API, способное принимать промты на любом языке мира. Даже если запрос написан по-русски или на любом другом языке, система автоматически переведёт нужные фрагменты текста, ведь “под капотом” у Veo 3 всё же англоязычная нейросеть.

Особое внимание стоит уделить правилам отправки запросов. Промт — обязательный элемент для генерации, а вот референс можно добавлять по желанию. Если вы решите использовать изображение в качестве референса, помните: разрешено прикладывать только одну картинку (в качестве стартового кадра). Форматы — jpg, jpeg или png, минимальный размер — 500 на 500 пикселей. Чем крупнее изображение, тем лучше для результата.

Желательно, чтобы картинка была в соотношении сторон 16:9 — ведь Veo 3 формирует только “альбомные” кадры. Если вы отправите картинку в другом формате, нейросеть просто обрежет её до нужных пропорций, взяв по центру нужную часть. Очень важно, чтобы ссылка на референс была прямой и содержала указание mime-type image/*.

Стоимость генераций указана в нашем актуальном прайс-листе.

Для работы с API понадобится авторизационный токен — подробная инструкция по его получению размещена на нашем сайте.

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

Пример запроса к API Veo 3:

curl -X POST https://api.yesai.su/v2/yesvideo/aniimage/veo -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{ "prompt": "девушка идет по оживленной городской улице и говорит на русском 'нейросеть veo 3 умеет генерировать видео со звуком'. солнечный день, париж, эйфелева башня", "references_urls":["https://yoururl.com/image1.jpeg"], "quality":"fast" }'

Чтобы отправить задание нейросети, понадобятся определённые параметры. Вот, что нужно указать:

prompt = '' - основное и самое важное поле. Здесь формулируется ваша задача для нейросети. Текст может быть на любом языке, главное — не менее трёх символов.
references_urls = [] - по желанию сюда добавляют ссылки на изображения-референсы, которые помогут системе понять, какой стиль или объекты вас интересуют. В настоящее время можно приложить только одну ссылку.
quality = '' - отвечает за качество создаваемой анимации. По умолчанию стоит 'fast', то есть быстрое, а если нужна более детализированная картинка — выбирайте 'quality'.

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

['success' => false, 'message' => 'PROMPT_IS_EMPTY'], 400
['success' => false, 'message' => 'PROMPT_NOT_VALID'], 400
['success' => false, 'message' => 'QUALITY_IS_EMPTY'], 400
['success' => false, 'message' => 'QUALITY_NOT_VALID'], 400
['success' => false, 'message' => 'CUSTOMER_ID_IS_EMPTY'], 400
['success' => false, 'message' => 'CUSTOMER_ID_NOT_VALID'], 400
['success' => false, 'message' => 'REFERENCES_URLS_IS_EMPTY'], 400
['success' => false, 'message' => 'REFERENCES_URLS_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'QUALITY_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' => 'REFERENCES_URLS_LIMIT_EXCEEDED'], 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}. Этот номер позволит отслеживать, на какой стадии находится выполнение вашего задания, а также получить ссылку на готовый ролик, когда обработка завершится.

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

Пример запроса к API Veo 3 для получения статуса выполнения задания:

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

В системе предусмотрено несколько вариантов статусов заданий:

"status": 0 ("status_description":"in queue") - в очереди. Это означает, что ваше задание ожидает своей очереди на обработку. Здесь главное – набраться терпения и немного подождать.
"status": 1 ("status_description":"in progress") - выполняется. Ваше задание уже обрабатывается. В этот момент также стоит просто дождаться завершения процесса.
"status": 2 ("status_description":"completed") - выполнено успешно. Задание завершено, и можно переходить к дальнейшей работе с полученным результатом.
"status": 3 ("status_description":"rejected with error") - отклонено с ошибкой. По техническим причинам задание не было выполнено. Рекомендуется ознакомиться с комментариями к отказу (они доступны на русском и английском языках) и выяснить причину проблемы.
"status": 4 ("status_description":"rejected due to timeout") - отклонено из-за таймаута. В этом случае выполнение задания заняло слишком много времени, и система завершила его с ошибкой. Оптимальный выход – попробовать отправить задание снова.

Что означают параметры в API-ответе Yes Ai, когда задача успешно завершена в нейросетевом сервисе Veo 3:

{ "success": true, // данные успешно получены "message": "OK", "results": { "animation_data": { "id": 42138, "user_id": 1234567890, "tariff_id": 30, "type": 25, "styles": [], "settings": { "customer_id": "", "veo_quality": "standard", // версия нейросети Veo 3, где standard - это генерация по промту и референсу, а fast - генерация по промту без референса "veo_references_urls": [ "https://yoururl.com/image1.jpeg" ] }, "child_ids": [], "parent_id": 0, "photo_url": "", "image_url": "", "audio_url": "", "video_url": "", "final_frame_url": "", "result_url": "https://yesai.su/files/yesvideo/animations/1234567890_1754567050471203.mp4", // ссылка на скачивание результата генерации "result_type": "video", "result_data": { "video_fps": 24, "video_width": 1280, "video_height": 720, "video_duration": 8, "video_durrange": 0 }, "comment_ru": "", // комментарий к заданию на русском языке, он заполняется только в том случае, если задание не удалось выполнить "comment_en": "", // комментарий к заданию на английском языке, он заполняется только в том случае, если задание не удалось выполнить "accounting": { "total_cost": 300, "spent_points": 0, "spent_rpoints": 300, // количество 🔅 монет, которые были сняты с баланса за выполнение задания "spent_repost_points": 0, "spent_balance": 0, "spent_rbalance": 0, "remaining_points": 1820, "remaining_rpoints": 2482.86971264, // остаток 🔅 монет на балансе после выполнения задания "remaining_repost_points": 0, "remaining_balance": 0, "remaining_rbalance": 263.03231 }, "language": "", "prompt": "девушка идет по оживленной городской улице и говорит на русском 'нейросеть veo 3 умеет генерировать видео со звуком'. солнечный день, париж, эйфелева башня", "prompt_en": "", "prompt_language": "", "status": 2, // статус задания, где 2 - успешное завершение "status_description": "completed", // текстовое пояснение у статусу задания, где completed означает успешное завершение "start_at": 1750566026, // unixtime, время начала выполнения задания "finish_at": 1750567050, // unixtime, время завершения выполнения задания "created_at": 1750566023, // unixtime, время подачи задания клиентом "updated_at": 1750567050, // unixtime, время последнего обновления статуса задания "deleted_at": 0 } } }

Когда ваш запрос на создание видео с помощью Veo 3 обрабатывается успешно, вы получаете специальную ссылку для загрузки ролика в формате MP4. Обратите внимание: ссылка активна только 60 минут, после чего файл автоматически удаляется с нашего сервера.

Рекомендуем сразу после завершения обработки задания скачать полученное видео на собственный сервер — это позволит избежать потери итогового файла.

Сервис Yes Ai позволяет отправлять задания через API и отслеживать их статус при соблюдении определённых условий.

Требования к изображениям для новых заданий:

Анимационные изображения должны весить не больше 5 МБ, а их максимальное разрешение — 2000 пикселей по любой стороне.
Допускаются форматы: jpeg, jpg и png.

Подача новых заданий через POST-запросы API:
Новые задания можно отправлять с частотой не чаще одного раза в секунду.

Оригинальная документация Veo3

С 25 июня 2025 года в сервисе Yes Ai начали действовать обновлённые правила, регулирующие количество заданий, которые пользователь может отправить на обработку одновременно. Теперь всё зависит от выбранного тарифного плана.

Для нейросети Veo эти ограничения выглядят следующим образом:

Без тарифа — до 20 заданий в очереди;
Тариф Micro — те же 20 заданий;
Тариф Start — также 20 заданий;
Тариф Standard — 20 заданий;
Тариф VIP — лимит увеличен до 40 заданий в очереди.

Важный момент: лимиты распространяются на каждую нейросеть отдельно. Это значит, что используя пакет VIP, вы сможете одновременно отправить, например, 40 заданий Veo 3, плюс ещё по 40 заданий для Midjourney, Dalle 3 и других сервисов.

Чтобы не столкнуться с неожиданными ограничениями, рекомендуем отслеживать свои задания самостоятельно, распределяя их по внутренней очереди. Если же вам требуется повысить лимит, не стесняйтесь обращаться в техническую поддержку – вам всегда рады помочь и обсудить возможные решения.

Если у вас возникли вопросы по работе с API от Yes Ai, рекомендуем обращаться в официальную техническую поддержку. Связаться со специалистами можно через мессенджер Telegram по адресу: @yes_ai_support

Обзор API Veo 3, нейросети для генерации видео роликов

Что выделяет Veo 3 среди аналогов

Как отправить заявку на генерацию видео в нейросети Veo 3 через API: пошаговая инструкция

Проверка статуса выполнения по {id} через API:

Пример JSON-ответа API при запросе статуса выполнения задания

Обработка заявок на генерацию видео через API Yes Ai (Veo 3): что важно знать

Ограничения при постановке и мониторинге заданий

Новые лимиты на количество одновременных заданий в Yes Ai: что важно знать