Введение
Wan 3.0 Pro Prime Изображение в видео оживляет первый кадр на рендере Prime и выдаёт его в 1080p, 2K или 4K длиной от 2 до 30 секунд. image_url обязателен и становится ровно первым кадром; промпт необязателен и должен описывать движение и камеру; last_image_url по желанию закрепляет последний кадр. Поля в точности совпадают с Wan 3.0 Pro Изображение в видео, так что запрос, собранный для того эндпоинта, работает здесь при замене только имени модели.
Выберите режим по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменный бриф задаёт сцену, действие, камеру и при необходимости звук. | Wan 3.0 Pro Prime Текст в видео |
| Утверждённое стартовое изображение задаёт объект и композицию, а инструкция направляет последующее движение. | Wan 3.0 Pro Prime Изображение в видео |
| Отдельные референсы могут направлять идентичность, место, движение или звук, если каждому назначена ясная роль. | Wan 3.0 Pro Prime Референсы в видео |
Ключевые возможности и особенности
Команды на два кадра, например перевод фокуса
Перевод фокуса по своей природе состоит из двух кадров, и именно для этого нужен last_image_url. Пример с бутоном открывается резким бутоном цветка и заканчивается переданным кадром, где резкость на расстёгнутой рубашке позади, — 6 секунд в 4k; промпт говорит только, когда происходит переход. Очень малая глубина резкости почти не оставляет рендеру свободы попасть в нужную плоскость без закреплённого финала.
Потолок задаёт исходник, а не ступень
Разрешение управляет рендером, а не входом. Ступени 2k и 4k увеличены из нативного рендера 1080p, поэтому передавайте самый резкий кадр, какой есть: JPEG, PNG без прозрачности, BMP или WEBP от 240 до 8000 пикселей по стороне, до 20 МБ и не шире 8:1.
Статичные планы для монтажа с отдельной музыкой
Пример «свет в переулке» — 4-секундный статичный план в 2k с выключенными звуком и расширением промпта: «Nobody moves. Only the neon tube above her stutters and the rain keeps falling, dragging its reflection across the wet plastic. Locked camera.» Это форма запроса для плана, который озвучат при монтаже, а не снабдят собственным звуком.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Нет | Здесь необязателен. Тратьте его на движение и камеру: пересказ того, что и так видно в кадре, провоцирует модель это перерисовать. Не менее 1 символов · Не более 20000 символов |
image_url | Да | Стартовый кадр: используется ровно как первый кадр и задаёт настоящий потолок качества всего плана. Не менее 1 символов |
last_image_url | Нет | Необязательный, работает только вместе с |
resolution | Нет | 1080p, 2k или 4k, по умолчанию 1080p. |
aspect_ratio | Нет | adaptive идёт за стартовым кадром. Закрепляйте соотношение только тогда, когда этого требует формат сдачи. |
duration_seconds | Нет | Любое целое число от 2 до 30, по умолчанию 5, или -1 — умная длительность, при которой длину выбирает модель: заранее резервируется максимум в 30 секунд, а списание идёт по факт… |
generate_audio | Нет | Включён по умолчанию. Звук генерируется вместе с картинкой и приходит внутри того же файла. По умолчанию: |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
seed | Нет | От 0 до 2147483647. Фиксируйте его, пока подбираете разрешение или длительность, иначе каждый перезапуск меняет сразу две вещи. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.234 / секунду |
| $0.252 / секунду |
| $0.279 / секунду |
Сценарии использования
Меняющееся окружение вокруг неподвижного героя
Пример с неоновым переулком начинается с кадра, где уже есть переулок, дождь и прозрачный дождевик, поэтому промпт говорит только о том, что меняется: дождь усиливается, неоновая трубка один раз мигает, из решётки вырывается пар, а героиня всё это время держит взгляд в объектив. Строка звука называет каждый источник — дождь по стали, гудящая трубка, шипящая решётка.
Крупные детали с закреплённым финалом
Пример с рубашкой повторно использует те же два кадра, что и пример с бутоном, в 1080p на 4 секунды: рука медленно отводит расстёгнутую рубашку в сторону в скользящем золотом свете и отпускает её, а бутон между складками чуть раскрывается. Закреплённые концы помогают очень малой глубине резкости попасть в нужную плоскость.
Руководство по промптам и практические советы
Не пишите в промпте то, что уже видно
Повторное описание того, что уже есть в кадре, подталкивает модель перерисовать это. Используйте промпт только для движения и камеры и оставляйте aspect_ratio в значении adaptive, чтобы клип следовал форме кадра; задавайте соотношение, только когда этого требует формат выдачи.
Утверждайте в 1080p, выдавайте в 2K или 4K
Закрепите движение на 5 секундах в 1080p с фиксированным seed, затем отправьте тело запроса в 2k или 4k. Любой повтор, меняющий и разрешение, и сид, меняет две вещи сразу, поэтому одно должно оставаться неизменным, пока вы оцениваете другое.
Для точного движения выключайте расширение
В этом семействе enable_prompt_expansion по умолчанию равно true. Оно помогает идее из двух слов и переписывает точное описание движения; пример «свет в переулке» выключает его, чтобы три коротких предложения выполнялись как написано. Принимается любая целая длительность от 2 до 30 секунд, а -1 передаёт выбор длины модели.
Быстрый старт 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": "alibaba/wan-3.0-pro-prime/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"image_url": "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.



























