Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
bgm | Нет | Add a background music bed that fits the scene. По умолчанию: true |
duration_seconds | Нет | Длина ролика. Оплата посекундная. ≥ 1 · ≤ 16 · По умолчанию: 5 |
generate_audio | Нет | Добавляет звук под картинку: голоса, атмосферу и эффекты. По умолчанию: true |
image_url | Да | Картинка, с которой всё начинается. |
movement_amplitude | Нет | Насколько сильно двигаются объект и камера. auto · small · medium · large · По умолчанию: auto |
prompt | Да | Describe what happens after the opening frame: the action, the camera, and the mood. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 540p · 720p · По умолчанию: 720p |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| resolution 540p | 6,3 | 0,063 $ |
| resolution 720p | 9,9 | 0,099 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 32 кредита за клип длиной 5 с (0,32 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Vidu Q3 Turbo в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model vidu/q3-turbo/image-to-video и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "vidu/q3-turbo/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"movement_amplitude": "auto",
"duration_seconds": 5,
"resolution": "720p"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Vidu Q3 Turbo
Сколько стоит API Vidu Q3 Turbo?
Vidu Q3 Turbo стоит от 32 кредита (0,32 $) за клип длиной 5 с — на самой дешёвой задаче «Видео из картинки». Цены по вариантам: 540p 6,3 кредита за секунду, 720p 9,9 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Vidu Q3 Turbo в API?
Укажите vidu/q3-turbo/image-to-video — Видео из картинки; vidu/q3-turbo/video-extend — Продлить видео в поле model запроса POST /jobs/createTask.
Как управлять тем, сколько движения будет?
Через промпт и movement_amplitude. Назовите движение прямо — перенос веса, полуоборот, уход из кадра, — держите его совместимым с тем, что показывает стартовый кадр, а общий объём движения задайте в movement_amplitude (auto, small, medium, large). Меняется то, насколько далеко перемещаются субъекты в кадре, а не длина клипа.
Какой максимальной длины бывает клип?
От одной до шестнадцати целых секунд. Одна-четыре секунды — удобный диапазон, пока вы гоняете варианты. Все шестнадцать доступны, когда одному действию нужен воздух.
Какие разрешения поддерживаются?
540p и 720p, по умолчанию 720p. 540p — черновой проход, 720p — сдаточный, и между ними в запросе меняется одно значение.
Генерирует ли он звук?
Да. generate_audio по умолчанию true, поэтому клип приходит с синхронной дорожкой. Поставьте false, если нарезка ляжет под готовый микс.
Какие ограничения у API Vidu Q3 Turbo?
Длина клипа: 1–16 s; Разрешения: 540p · 720p. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Vidu Q3 Turbo без кода?
Да. Playground запускает Vidu Q3 Turbo на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Vidu
- Vidu Q4 Preview APIКлипы до 4K со звуком и диалогамиОт 34 кредитов за клип длиной 5 с
- Vidu Q3 Turbo APIБыстрая анимация картинки со звуком, до 16 секундОт 32 кредитов за клип длиной 5 с
- Vidu Q3 APIОживляет кадр до 16 секунд в 1080pОт 53 кредитов за клип длиной 5 с
- Vidu Q3 Pro APIОживляет кадр, звук включён по умолчанию, до 16 секундОт 41 кредита за клип длиной 5 с

