Wan 3.0 Prime API

Wan 3.0 Prime Референсы в видео собирает на рендере Prime план длиной от 2 до 30 секунд из не более чем десяти изображений, пяти видео и пяти аудио в качестве референсов, с теми же полями, что и Wan 3.0 Референсы в видео. Нужен хотя бы один массив референсов, файл-референс или веб-ссылка, промпт необязателен; если вы его пишете, в нём должно быть сказано, за что отвечает каждый референс. Разрешение — 480p, 720p или 1080p, по умолчанию 720p, а aspect_ratio по умолчанию 16:9.

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

Один референс внешности — и целая сцена из текста

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

Поведение камеры, взятое из клипа

Видеореференс нужен для движения и манеры камеры, а не для лиц. Пример со стилем движения берёт из референсного клипа медленный облёт с рук и применяет его к женщине с референсного изображения, стоящей в пустой студии, — 6 секунд в 720p. Референсные клипы должны быть в MP4 или MOV, не менее 16 кадров в секунду, по 1–15 секунд каждый и суммарно до 15 секунд.

Непрерывность голоса через аудиореференсы

До пяти аудиореференсов WAV или MP3 общей длиной 15 секунд удерживают голос от дубля к дублю. Ведущая, которая выглядит одинаково, но в разных планах звучит по-разному, всё равно не непрерывна, поэтому, если человек говорит в нескольких планах, каждый раз отправляйте один и тот же аудиореференс. Аудио и изображения-референсы не оплачиваются.

Постоянная ведущая

Используйте в каждом запросе серии одни и те же изображения для лица и декорации и один и тот же аудиореференс для голоса. Пример с ведущей сохраняет «the same presenter, the same studio» и описывает только движение — наезд, заканчивающийся на определённом кадрировании, — ведь внешность уже несут референсы.

Вставки в едином стиле

Если новый план должен двигаться так же, как уже существующий, передайте этот клип как референс движения, а для объекта — изображение. Укажите в промпте, что есть что, как в примере со стилем движения: «Take the camera behaviour from the reference clip — a slow handheld orbit — and apply it to the woman in the reference image.»

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