Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime Референсы в видео закрепляет лицо, одежду, декорации, движение или голос референсами-изображениями, видео и аудио и рендерит план на Prime в 1080p, 2K или 4K длиной от 2 до 30 секунд. Нужно хотя бы одно из полей reference_image_urls (от 1 до 10 упорядоченных изображений), reference_video_urls, reference_audio_urls (до 5 клипов в каждом), reference_file_url (один документ) или reference_link_url (одна веб-страница). Называйте каждый референс в промпте, иначе модель усреднит их в объект, не совпадающий ни с одним.

Выберите режим по исходному материалу

Два персонажа в одном плане

Пример с двумя персонажами отправляет два референса и подписывает их: «The first image is the woman, the second is the man — keep both faces and both haircuts.» Они стоят по разные стороны верстака в полутёмном гараже под одной висящей лампочкой — 6 секунд в 1080p с сидом 220913 и только звучанием помещения. Это схема, которая удерживает пару узнаваемой на протяжении эпизода.

Референс декорации без людей

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

Движение по референсу, а не по тексту

Изображения, видео и аудио можно передавать вместе, так что движение может прийти из клипа, а не из абзаца. Видеореференсы — MP4 или MOV, не менее 16 кадров в секунду, по 1–15 секунд и суммарно до 15 секунд; их секунды оплачиваются вместе с результатом, а видеореференсы плюс результат укладываются в 30 секунд.

Костюм на нескольких сценах

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

Мастер-файлы для перемонтажа

Отрендерьте закреплённый референсами главный план в 4K и 16:9, а затем вырежьте из того же мастера версию 9:16 и квадратный баннер. Референсы и фиксированный сид удерживают состав одинаковым во всех производных версиях.

# 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": "alibaba/wan-3.0-pro-prime/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "resolution": "1080p"
  }
}'

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