Введение
Vidu Q4 Preview Reference to video собирает одну сцену из 1–15 референсных изображений и до 3 голосовых клипов. Vidu Q4 Preview — публичная превью-версия видеомодели Q4 от Vidu. Клипы длятся 3–16 секунд, от 540p до 4k, в пяти соотношениях сторон, со звуком, который генерируется вместе с изображением. Этот эндпоинт фильтруется слабо: начиная с уровня «Умеренный» большинство запросов смягчается или отклоняется.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| кадр, который нужно оживить | Vidu Q4 Preview Изображение в видео |
| люди, наряды, товары или места в виде изображений, с необязательными голосовыми клипами | Vidu Q4 Preview Референсы в видео |
Ключевые возможности и особенности
До 15 референсов
Люди, наряды, товары и места можно отправлять вместе. В наших запусках лицо, одежда и интерьер вернулись одной сценой.
Два человека, оба узнаваемы
Два портрета в референсах сохранили оба лица в одном кадре.
Референсный голос
До 3 аудиоклипов задают голос. Слова по-прежнему берутся из промпта, поэтому пишите реплику в кавычках.
Пять форматов и пять уровней
aspect_ratio предлагает 16:9, 9:16, 1:1, 3:4 и 4:3; resolution идёт от 540p до 4k, а 2k и 4k приходят в 10-bit HEVC.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательно, до 20 000 символов. Опишите сцену и ссылайтесь на референсы по порядку, например "the woman from the first image". Не менее 1 символов · Не более 20000 символов |
reference_image_urls | Да | Обязательно, от 1 до 15 изображений людей, нарядов, товаров или мест. Запрос без них отклоняется. Не менее 1 элементов · Не более 15 элементов |
reference_audio_urls | Нет | Необязательно, до 3 голосовых клипов (Vidu просит MP3 по 3–12 секунд каждый). Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | 16:9 (по умолчанию), 9:16, 1:1, 3:4 или 4:3. На цену не влияет. |
resolution | Нет | 540p, 720p (по умолчанию), 1080p, 2k или 4k. Определяет цену за секунду: 2k стоит дороже 1080p, а 4k — примерно вдвое дороже 2k. |
duration_seconds | Нет | Целые секунды, от 3 до 16, по умолчанию 5. Оплата за секунду вместе с разрешением. |
generate_audio | Нет | По умолчанию включено: диалоги, эффекты и атмосферный звук создаются вместе с картинкой. Отключите, чтобы получить клип без аудиодорожки. По умолчанию: |
seed | Нет | Помогает сравнивать запуски, пока вы меняете что-то одно за раз. Идентичного кадр в кадр клипа он не обещает. |
Стоимость
Оплата за секунду результата при выбранном разрешении. Звук, число референсных изображений и число референсных аудиоклипов на цену не влияют. Отклонённые запросы не тарифицируются.
| Спецификация | Стоимость |
|---|---|
| $0.045 / секунду |
| $0.095 / секунду |
| $0.12 / секунду |
| $0.19 / секунду |
| $0.39 / секунду |
Сценарии использования
Сцены о моде и товарах
Модель, одежда и локация в одном клипе.
Кадры с двумя людьми
Разговор, приход или почти-поцелуй с сохранением обоих лиц.
Персонажи с голосом
Портрет плюс голосовой клип и реплика в кавычках.
Руководство по промптам и практические советы
Ссылайтесь по порядку
Пишите "the woman from the first image" и "the robe from the second image".
Пишите реплику
Голосовой клип не даёт слов. Возьмите реплику в кавычки и укажите, что она произносится голосом из референсного аудио.
Знайте фильтр
Запросы уровня «Мягкий» проходили, как и один из двух промптов уровня «Максимальный»; начиная с уровня «Умеренный» остальные в наших тестах отклонялись или смягчались, а отказы не списываются. Для сцен за пределами этих ограничений используйте изображение в видео из кадра с людьми.
Черновик в 540p
Проверьте промпт в 540p, затем доработайте в 1080p. Выбирайте 2k или 4k, только если справляетесь с файлами HEVC.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "vidu/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.












