Wan 3.0 Pro API

Wan 3.0 Pro Изображение в видео оживляет первый кадр и выдаёт клип в 1080p, 2K или 4K длиной от 2 до 30 секунд. Обязательное поле одно — image_url, и оно используется ровно как первый кадр, поэтому одежда, тело, декорации и свет берутся из вашего изображения; промпт необязателен и должен описывать только движение и камеру. last_image_url по желанию точно задаёт последний кадр и работает только вместе с image_url. Звук генерируется вместе с изображением, если вы его не отключите.

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

4K-рендер не сделает мягкий кадр резким

Первый кадр — потолок качества плана, а ступени 2k и 4k увеличивают нативный рендер 1080p, не дорисовывая новых деталей. Мягкий или низкокачественный исходник останется мягким и в 4K. Передавайте самое резкое изображение, какое есть: JPEG, PNG без прозрачности, BMP или WEBP от 240 до 8000 пикселей по стороне, до 20 МБ и не шире 8:1.

Оба конца закреплены — мастер готов к монтажу

Пример с флаконом передаёт один и тот же пэкшот и в image_url, и в last_image_url в 4k, с отключёнными расширением промпта и звуком и фиксированным сидом 5512090. Флакон поворачивается на четверть оборота, блик проходит по всей длине стекла, и он возвращается к исходному ракурсу — получается мастер, этикетка которого остаётся читаемой, когда монтажёр делает цифровой наезд.

Кадр по умолчанию следует исходнику

aspect_ratio по умолчанию равно adaptive и следует первому кадру. Задавайте 16:9, 4:3, 1:1, 3:4 или 9:16, только когда формат выдачи фиксирован. Ни один из четырёх опубликованных примеров не задаёт соотношение, так что каждый клип сохраняет форму своего исходного изображения.

Долгий путь к утверждённому финалу

Пример с вершиной передаёт подножие горы в image_url, а вершину в last_image_url и рендерит 10 секунд в 4K; промпт описывает только подъём между ними. Долгое восхождение — как раз то место, где незакреплённый финал уплывает; закреплённый последний кадр позволяет утвердить развязку как статичный кадр, прежде чем платить за 4K-рендер.

Одежда остаётся в кадре

Пример с шёлковым плечом начинается с кадра, где одежда уже есть, поэтому промпт целиком отдан движению: плечи медленно поворачиваются к камере, шёлк ловит свет, дыхание успокаивается, медленный push-in с одним жёстким светом слева и дождём на окне позади. Рендер — 5 секунд в 2k.

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