Vidu Q3 Turbo API

Vidu Q3 Turbo — быстрый уровень линейки Q3 от Vidu, доступный как эндпоинты «изображение в видео» и video-extend; эта страница посвящена «изображению в видео». Стартовый кадр в image_url задаёт героя и форму результата, обязательный prompt управляет движением, камерой и звуком, а ролики длятся от 1 до 16 целых секунд в 540p или 720p, по умолчанию 720p. Звук создаётся в том же проходе и остаётся включённым, пока вы не поставите generate_audio в false. Этот уровень рассчитан на то, чтобы перепробовать много движений из одного снимка, прежде чем выбрать дубль для сдачи.

Черновое значение и значение для сдачи

resolution принимает 540p или 720p, и 720p на этом эндпоинте — одновременно значение по умолчанию и потолок. Два значения работают в паре: 540p — для прогонов, пока движение ещё ищется, 720p — для дубля, который вы сдаёте. Разрешение — это одно поле, поэтому переключение не затрагивает ни промпт, ни кадр, ни seed.

Короткие варианты из одного кадра

Длительность — от 1 до 16 целых секунд, а для прогонов с вариантами практичный диапазон — от одной до четырёх секунд. Сгенерируйте серию коротких дублей из одного снимка, в каждом с одним другим движением, и оставьте удачные — вместо того чтобы писать одно сложное задание в надежде, что оно сработает.

Героя и форму определяет снимок

Герой, одежда, стайлинг, кадрирование и форма результата берутся из изображения, а не из промпта, поэтому два прогона с одним кадром различаются движением, а не тем, кто на экране. movement_amplitude задаёт общий объём движения; что движется, решает промпт. Текст, который спорит со снимком, даёт ролик, пытающийся примирить одно с другим, поэтому держите промпт в согласии с тем, что показывает кадр.

Серии реакций персонажа

Один снимок в костюме превращается в реверанс, подмигивание, взмах рукой и наклон головы — четыре запроса, один кадр, четыре промпта. Поскольку изображение закрепляет внешность, серия остаётся достаточно цельной, чтобы смонтировать её в ленте.

Квадратные и вертикальные нарезки для соцсетей

Форма результата берётся из снимка, поэтому вертикальный кадр 9:16 и квадрат 1:1 — это два экспорта на этапе изображения, а не две разные видеонастройки. Каждый оживает в ролик 720p с уже синхронным звуком.

Проверка движения камеры на одном снимке

Пример с push-in задаёт одно движение и ничего больше: кадр постепенно сужается, пока не останется только её плечо. Используйте ту же схему, чтобы проверить, держится ли герой по мере сужения кадра, прежде чем писать длинное задание.

Петли без цензуры из ваших снимков

Исходные кадры без цензуры оживают такими, какими их прислали, а диапазон от одной до четырёх секунд подходит, чтобы собрать серию коротких вариантов из нескольких снимков. Vidu Q3 Spicy из той же линейки — донастроенный через LoRA вариант без цензуры.

# 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/q3-turbo/image-to-video",
  "input": {
    "duration_seconds": 5,
    "image_url": "https://example.com/reference.png",
    "movement_amplitude": "auto",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "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.