Введение
Wan 3.0 Pro Текст в видео строит план по промпту и выдаёт его в 1080p, 2K или 4K длиной от 2 до 30 секунд со сгенерированным звуком в том же файле. Обязательное поле одно — prompt, и оно принимает до 20 000 символов. Нативный рендер Wan 3.0 ограничен 1080p, поэтому ступени 2k и 4k получаются увеличением этого рендера, а не отрисовкой в таком размере. Ступеней 480p и 720p у этого эндпоинта нет — эти размеры закрывает Wan 3.0.
Выберите режим по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменный бриф задаёт сцену, действие, камеру и при необходимости звук. | Wan 3.0 Pro Текст в видео |
| Утверждённое стартовое изображение задаёт объект и композицию, а инструкция направляет последующее движение. | Wan 3.0 Pro Изображение в видео |
| Отдельные референсы могут направлять идентичность, место, движение или звук, если каждому назначена ясная роль. | Wan 3.0 Pro Референсы в видео |
Ключевые возможности и особенности
Три размера выдачи из одного нативного рендера
resolution принимает 1080p (по умолчанию), 2k или 4k. Две старшие ступени растягивают то, что нарисовала модель, а не дорисовывают новое, поэтому подходят для материала, который будут кадрировать, трекать или проецировать, и они не лучше исходного рендера. Сначала найдите кадр в 1080p, а 4K считайте этапом выдачи.
Расширение промпта включено с самого начала
В этом семействе enable_prompt_expansion по умолчанию равно true. Оно дополняет скупой бриф, что удобно на этапе набросков, но переписывает подробный. Как только промпт станет точным описанием кадра, поставьте false, чтобы выполнялась именно отлаженная вами формулировка.
Адаптивный формат, пока вы не зададите свой
aspect_ratio по умолчанию равно adaptive, и формат выбирает модель. Указывайте 16:9, 4:3, 1:1, 3:4 или 9:16, когда формат выдачи задан: пример с забором просит 9:16 для вертикального кадра, а примеры с парфюмом, чёрно-белым фильмом и тату фиксируют 16:9.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Герой, одно действие, одно движение камеры, затем свет и звук. В 4K расплывчатый бриф стоит настоящих денег, поэтому пишите кадр, а не настроение. Не менее 1 символов · Не более 20000 символов |
resolution | Нет | 1080p, 2k или 4k, по умолчанию 1080p. |
aspect_ratio | Нет | 16:9, 4:3, 1:1, 3:4, 9:16 или adaptive. По умолчанию adaptive, то есть выбирает модель; называйте формат, когда он у сдачи фиксирован. |
duration_seconds | Нет | Любое целое число от 2 до 30, по умолчанию 5, или -1 — умная длительность, при которой длину выбирает модель: заранее резервируется максимум в 30 секунд, а списание идёт по факт… |
generate_audio | Нет | Включён по умолчанию. Звук генерируется вместе с картинкой и приходит внутри того же файла. По умолчанию: |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
seed | Нет | От 0 до 2147483647. Фиксируйте его, пока подбираете разрешение или длительность, иначе каждый перезапуск меняет сразу две вещи. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.144 / секунду |
| $0.16 / секунду |
| $0.184 / секунду |
Сценарии использования
Парфюмерные и бьюти-ролики в жёстком свете
Пример с парфюмом — пятисекундный ролик в замедлении: взрослая женщина в чёрном платье с открытой спиной отворачивается от окна, по которому хлещет дождь, единственный жёсткий рисующий свет скользит вдоль позвоночника, с волос слетают капли, а в звуке — низкая нота виолончели и дождь. Блестящая ткань, один жёсткий источник и мелкие быстрые частицы первыми разваливаются при увеличении, так что в выдаче 2K или 4K проверяйте именно их.
Ткань, которую двигает одна внешняя сила
Два примера управляют одеждой через одну силу, а не описывают, как она сидит. В чёрно-белом фэшн-фильме три метра шёлкового шифона перед промышленным ветродувом хлещут вокруг тела и обвиваются вокруг плеча под жёстким светом на чёрном фоне. В примере с забором струя от садящегося самолёта прижимает одежду двух людей к телу. Названная сила даёт ткани причину, которой она будет следовать.
Руководство по промптам и практические советы
Ищите в 1080p, потом перерендерьте выбранный сид
Найдите кадр на 5 секундах в 1080p с фиксированным seed, меняйте одно поле за повтор и лишь затем отправьте тот же промпт с тем же сидом и resolution равным 4k. Если менять разрешение и текст в одном повторе, не понять, что именно сдвинуло результат.
Пишите кадр, а не настроение
Объект, одно действие, одно движение камеры, затем свет и звук. Хороший образец — промпт тату-салона: свечи и одна настольная лампа как единственный свет, руки в перчатках прорабатывают тени рисунка на рёбрах, гримаса, медленный выдох и улыбка через плечо, гудение машинки, очень медленный наезд. В 4K размытый бриф — дорогой способ выяснить, что вы имели в виду.
Называйте звуки, которые хотите услышать
Звук генерируется вместе с картинкой, поэтому перечисляйте его источники: ролик с парфюмом просит «low cello note and rain», фильм с ветродувом — «the roar of the fan and snapping cloth». Ставьте generate_audio в false, если музыку к ролику пишет композитор. Семейство принимает промпты без цензуры без заявления в запросе; согласие, права, возраст и соблюдение местного законодательства в отношении всех показанных людей — ваша ответственность.
Быстрый старт 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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.



























