Vidu Q3 Pro API: видео 540p со звуком

Name: Vidu Q3 Pro API
SKU: vidu/q3-pro/image-to-video
Price: 0.41 USD
Availability: InStock

Параметры запроса

Параметр	Обязательный	Описание
`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 · По умолчанию: 540p
`seed`	Нет	Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

Вариант	Кредиты за секунду	≈ USD
Стандарт	8,1	0,081 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 41 кредит за клип длиной 5 с (0,41 $).

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API Vidu Q3 Pro в три шага

Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
Отправьте запрос. Отправьте POST /jobs/createTask с model vidu/q3-pro/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-pro/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": "540p"
  }
}'

# 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 Pro

Сколько стоит API Vidu Q3 Pro?

Vidu Q3 Pro стоит 41 кредит (0,41 $) за клип длиной 5 с. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у Vidu Q3 Pro в API?

Укажите vidu/q3-pro/image-to-video — Видео из картинки в поле model запроса POST /jobs/createTask.

Что делает Vidu Q3 Pro?

Оживляет стартовый кадр, который вы прислали. Картинка задаёт героя, внешний вид и формат, а prompt описывает движение, камеру и звук. Клип длится от 1 до 16 целых секунд в 540p.

Как задать формат клипа?

Через сам кадр. Вертикальная картинка возвращается вертикальным клипом, квадратная — квадратным, так что формат результата решается ещё на этапе изображения.