Введение
Wan 3.0 Spicy «изображение в видео» — эндпоинт «изображение в видео» семейства Wan 3.0 Spicy, настроенный на отрисовку того, что стандартная версия смягчает. Начальный кадр в image_url и необязательный prompt дают от 2 до 30 секунд видео в 480p, 720p или 1080p со сгенерированным звуком. Кадр задаёт человека, наряд, обстановку и свет; промпт задаёт движение, камеру и звук. Добавьте last_image_url, чтобы зафиксировать концовку.
В теле запроса нет флага контента и нет декларации на каждый запрос. В нашем тесте из шести уровней контента 2026-09-30 каждый уровень вышел как в запросе.
Ключевые возможности и особенности
Шесть уровней проверено, шесть отрисовано
Мы прогнали наш стандартный тест контента в 480p и на пять секунд: шесть промптов на пяти уровнях интенсивности, от Мягкого до Максимального (тестовые промпты не публикуются). Ничего не было отклонено, скрыто или заменено на другого человека, и ни один промпт не потребовал смягчения.
Сам по себе он выходит за рамки промпта
Вот что нужно учитывать при планировании. В наших примерных съёмках мы отправили шесть начальных кадров с промптами, в которых говорилось, что наряд остаётся прежним; четыре вернулись с изменённым нарядом, включая каждый кадр с более чем одним человеком. Считайте промпт просьбой, а не гарантией, и просмотрите весь клип.
До 30 секунд одним запросом
duration_seconds принимает любое целое число от 2 до 30, по умолчанию 5. Запрос на пять секунд возвращает около 5,04 секунды при 30 кадрах в секунду. resolution — 480p, 720p (по умолчанию) или 1080p; и длина, и разрешение влияют на цену и время обработки.
Формат, звук и последний кадр
aspect_ratio принимает 16:9, 9:16, 1:1, 4:3 или 3:4; если не указывать, клип берёт формат кадра. generate_audio включён по умолчанию. last_image_url фиксирует финальный кадр: в нашем тесте клип закончился на переданном изображении, обрезанном до нужного формата.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Нет | Необязательно, но стоит написать: одно действие, одно движение камеры, одна заметка о звуке. Просьба не менять наряд не гарантирует, что на этой модели он останется неизменным. Не менее 1 символов |
image_url | Да | Обязательное. Стартовый кадр: человек, одежда, помещение и свет берутся из него. |
last_image_url | Нет | Необязательный финальный кадр. Клип заканчивается на этом изображении, обрезанном до нужного соотношения сторон. |
aspect_ratio | Нет | 16:9, 9:16, 1:1, 4:3 или 3:4. Если не указывать, клип берёт формат стартового кадра; другое соотношение обрежет кадр. |
resolution | Нет | 480p, 720p или 1080p, по умолчанию 720p. Чем выше разрешение, тем дороже секунда и дольше обработка. |
duration_seconds | Нет | Любое целое число от 2 до 30, по умолчанию 5. Оплата за каждую запрошенную секунду. |
generate_audio | Нет | По умолчанию включено, без доплаты: клип возвращается со звуком, совпадающим с картинкой. Установите false для беззвучного клипа. По умолчанию: |
enable_prompt_expansion | Нет | По умолчанию выключено, без доплаты. Когда включено, короткий промпт перед генерацией переписывается в более длинный; оставьте выключенным, если формулировка уже точна. По умолчанию: |
seed | Нет | От 0 до 2147483647. Держите значение фиксированным, пока сравниваете разрешения или длительности; это делает запуски сопоставимыми, но не идентичными покадрово. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.057 / секунду |
| $0.114 / секунду |
| $0.228 / секунду |
Сценарии использования
Сцены, которые отказываются делать другие API
Сцены, которые другие API отклоняют или смягчают: отправьте кадр, опишите движение, получите клип. Можно использовать только взрослых, давших согласие, и материалы с надлежащей лицензией; за права, возраст и местное законодательство в отношении всех изображённых людей отвечаете вы.
Компаньоны и ролевые персонажи
Храните один кадр персонажа и используйте его как стартовый для каждого клипа, меняя только действие. Лицо и одежду задаёт кадр, поэтому персонаж остаётся тем же человеком от клипа к клипу.
Длинные дубли с заранее заданным финалом
Запросите до 30 секунд и добавьте last_image_url, чтобы дубль закончился в позе, с которой начинается ваш следующий план.
Руководство по промптам и практические советы
Пусть стиль задаёт кадр
Одежду, помещение и свет закладывайте в кадр, а промпт оставьте для того, что движется. Пример с окном на этой странице был запущен с duration_seconds 5 и resolution 720p:
She turns from the rainy window toward the camera; the loose strap slides a little further down her shoulder and she lets it rest there, a slow half smile. Pink and cyan neon ripples over the wet glass and her collarbone. She stays in the velvet dress the whole time. Slow push-in. Rain on the glass, distant traffic hum.
Это точный запрос, по которому для этого эндпоинта создан клип из стартового кадра рядом.
Черновик в 480p, потом финал
Пятисекундный клип в 480p занимал в наших тестах около полутора минут. Отработайте идею там, зафиксируйте seed, затем пересоберите в 720p или 1080p. Меняйте по одному полю за запуск, чтобы каждое сравнение что-то вам говорило.
Когда одежда должна остаться
Никакая формулировка промпта не отучит эту модель надёжно менять наряд персонажа. Для клипа, где гардероб должен сохраниться, используйте стандартный Wan 3.0 «изображение в видео», а Spicy оставьте для сцен, где как раз и нужен этот уклон.
Быстрый старт 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-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
