Введение
Wan 2.6 Spicy Изображение в видео — единственный эндпоинт семейства моделей Wan 2.6 Spicy. Разрешённый к использованию стартовый кадр превращается ровно в 5, 10 или 15 секунд в 720p или 1080p, которые возвращаются со звуком. Кадр несёт гардероб, тело, декорации, свет и формат изображения; промпт несёт движение. Ничто в запросе не помечает клип, и никаких деклараций для каждого запроса не требуется.
Обязателен только image_url. Промпт, негативный промпт, звуковая дорожка, тип кадра, расширение промпта и seed — необязательные.
Ключевые возможности и особенности
Три фиксированные длительности
duration_seconds — это закрытый список из 5, 10 и 15, а не диапазон. Если отправить 7, вернётся ошибка валидации, а не округлённый клип, поэтому вы всегда знаете, за сколько секунд платите, и можете планировать монтаж вокруг трёх длительностей. Вода, волосы и руки хорошо держатся на пяти секундах и сильнее уплывают на пятнадцати — это стоит учесть, прежде чем выбирать самый длинный вариант.
Своя дорожка через audio_url
Клипы всегда возвращаются со звуком; переключателя, который бы его отключал, нет. Если реплика или музыкальный фрагмент должны попасть в определённый кадр, передайте их через audio_url, и клип подстроит под них синхронизацию губ и темп. Файл должен быть в формате WAV или MP3, длиной от 3 до 30 секунд и не больше 15 МБ.
Отдельное поле для исключений
negative_prompt — место, где в пределах 500 символов исключаются второй человек, реквизит, текст на экране или водяной знак, который кадр упорно воспроизводит. Промпт длиной до 1500 символов остаётся свободным для движения. Повторное описание одежды или декораций в промпте подталкивает модель перерисовать то, что кадр уже зафиксировал.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Стартовый кадр. Одежда, тело, площадка, направление света и соотношение сторон клипа приходят отсюда, поэтому кадрируйте его сразу под формат сдачи. |
prompt | Нет | Необязателен. Опишите, что происходит после кадра: одно действие, одно поведение камеры, одна ремарка про звук. Не более 1500 символов |
negative_prompt | Нет | То, чего быть не должно: второй человек, реквизит, надпись в кадре, водяной знак, который плашка упорно воспроизводит. Единственное место, где что-то исключают. Не более 500 символов |
duration_seconds | Нет | Ровно 5, 10 или 15. Всё остальное отклоняется, а не округляется, так что оплаченная длина никогда не станет сюрпризом. |
resolution | Нет | 720p или 1080p, по умолчанию 720p. Двигает и цену, и время возврата задачи. |
audio_url | Нет | Звуковая дорожка, за которой идёт клип: она ведёт синхрон губ и темп. Берите её, когда реплика или музыкальный акцент обязаны попасть в конкретный кадр. |
seed | Нет | От 0 до 2147483647. Держите его фиксированным, пока сравниваете разрешения или длины на одной плашке. |
shot_type | Нет | Один кадр — весь клип одним непрерывным дублем. Несколько — модель сама монтирует склейки: удобно для короткой сцены, но непрерывность теряется. |
enable_prompt_expansion | Нет | По умолчанию выключено, поэтому prompt уходит так, как вы его написали. Включайте, чтобы дополнить тощий бриф. По умолчанию: |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.095 / секунду |
| $0.1425 / секунду |
Сценарии использования
Вода и свет
Опубликованный пример с бассейном начинается с кадра пловчихи, которая выходит из бассейна на крыше в синий час. Поскольку кадр содержит наряд, воду и город за её спиной, промпт лишь говорит, что она поднимается выше, откидывает волосы назад и открывает глаза, глядя в камеру. Длительность — пять секунд в 720p.
Сцены на двоих
Кадр с двумя людьми обрабатывается так же, как любое другое продолжение: клип продолжает то, что показано в начальном кадре, и ничего не проверяется после. Пример с гримёрной сохраняет один и тот же кадр на всём протяжении клипа, пока один человек движется за другим; рендер в 1080p, пять секунд.
Персонажи-компаньоны с вашей голосовой дорожкой
Используйте изображение персонажа как стартовый кадр и загрузите записанную реплику через audio_url. Движения губ и темп следуют вашему дублю, так что одно и то же лицо может произнести сценарий, а не изображать общие движения.
Пятнадцатисекундные ролики за один вызов
Пятнадцати секунд хватает на целый преролл или карточку сторис без монтажа. Один стартовый кадр, одна строка действия, один запрос, а поскольку длительность — одно из трёх фиксированных значений, она известна до отправки.
Руководство по промптам и практические советы
Кадрируйте изображение под формат поставки
Снимок определяет человека, костюм, место, свет и пропорции клипа. Поля соотношения сторон нет, поэтому до отправки обрежьте его до 16:9, 9:16 или квадрата: перекадрирование потом стоит нового рендера. Отправляйте JPEG, PNG без прозрачности, BMP или WEBP от 240 до 8000 пикселей по каждой стороне и не больше 20 МБ.
Соберите клип из мелких движений
Пример со светом жалюзи состоит из двух крошечных движений: стопа сгибается, колено выпрямляется, пока шёлк смещается под ними. Остальное делает свет, когда полосы ползут, а штора колышется; камера — ручное покачивание от первого лица, а не движение. Такие небольшие конкретные действия дают кадру занятие, не требуя от него изменений.
Пропишите границу в промпте, если камера неподвижна
В десятисекундном примере с гримёрной всё важное лежит на одной горизонтальной линии, а промпт прямо говорит, что должно оставаться за кадром. Когда камера не движется, формулировка ограничения в промпте держится надёжнее, чем попытки удержать его построением кадра, потому что оно должно выполняться на протяжении всего клипа.
Адаптируйте приложенный пример
Начните с опубликованного примера с duration_seconds: 5, image_url: a publicly accessible URL, resolution: 720p. Замените объект и движение, сохранив контракт входных данных этого режима.
She rises further out of the water, sheets of it running off her shoulders and swimsuit, slicks her wet hair straight back with both hands and opens her eyes toward camera, droplets scattering. Blue-hour city towers glow behind, slow-motion water detail, ambient pool lap and distant traffic.
Точный запрос, по которому создан клип этого эндпоинта, сгенерированный из стартового кадра, показанного рядом.
Доведите в 720p, а выбранный вариант отрендерите в 1080p
Разрешение меняет и цену, и время выполнения задачи. Доведите движение в 720p, а затем заново отрендерите выбранный вариант в 1080p с тем же кадром и тем же seed (от 0 до 2147483647). Фиксируйте оба и при сравнении пяти секунд с пятнадцатью, иначе вы сравниваете два разных клипа, а не две настройки. Seed стабилизирует результат, но идентичный клип не гарантирован.
Быстрый старт 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-2.6-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.




























