Wan 2.7 Spicy Image-to-Video API

Autenticación

Authorization: Bearer YOUR_API_KEY

Model & pricing

Billed on the duration you request (a whole number of seconds from 2 to 15), not on the exact length of the returned file. Audio, a driving audio file, negative prompts and prompt rewriting cost nothing extra. Failed requests are not charged.

Limits (read this first)

Code examples

# ─── Image-to-video (first frame + prompt, audio generated) ─────
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.7-i2v-spicy",
    "image": "https://example.com/first-frame.jpg",
    "prompt": "slow cinematic push-in, water flowing, wind in the trees, natural ambient sound",
    "duration": 5,
    "resolution": "1080p"
  }'
# Response (async — a task is created):
# { "code": 200, "data": { "taskId": "clxxx", "state": "pending" } }


# ─── Drive the clip with your own audio (https WAV/MP3, 2-30 s) ───
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.7-i2v-spicy",
    "image": "https://example.com/character.png",
    "prompt": "she speaks to the camera and gestures naturally",
    "audio_url": "https://example.com/speech.mp3",
    "negative_prompt": "blurry, distorted face, extra limbs",
    "duration": 8,
    "resolution": "720p",
    "seed": 42
  }'


# ─── Poll for the result ──────────────────────────────────
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
# { "code": 200, "data": { "state": "completed", "resultUrls": ["https://r2.apimodels.app/..."] } }

Parámetros de la solicitud

Driving the clip with your own audio (audio_url)

Without audio_url the model generates sound to match the scene. With audio_url it drives the motion from your audio instead, and that audio is the track in the output. The upstream example use is a character speaking and gesturing.

Constraints: an https link to a WAV or MP3, 2 to 30 seconds, at most 15MB. audio: false takes priority — set it and the output is silent even if audio_url was given.

Automatic prompt rewriting (prompt_extend)

When enabled, your prompt is first expanded with camera, lighting, motion and sound detail, and the expanded version is what gets generated. It helps most with one-line prompts. The switch is on by default and costs nothing extra.

Pass prompt_extend: false to turn it off and have the model follow your text exactly. Turn it off when you have already written a long, precise prompt, when the exact scene in the first frame must be preserved, or when you need reproducible comparisons alongside seed — each rewrite differs, so a fixed seed alone will not line up.

What it is for: premium content and immersive experiences

The Spicy line is two complementary models. Wan 2.2 Spicy is the volume engine: silent, 5 or 8 seconds, from $0.03/s, for game sprites, chat avatars, social loops and animated feed covers. Wan 2.7 Spicy is the one you sell: native audio, 2 to 15 seconds, 1080p — the four scenarios below run on it.

Worth knowing from the latest upstream build: fuller audio, smoother motion and better frame consistency; anime-style and Asian-face scenes added; prompt rewriting now runs in half the time.

Notas

• Async: create a task for a taskId, then poll GET ?task_id= for the result
• The output is an H.264 MP4 at 30fps with an AAC track (unless audio: false)
• Same endpoint and key as wan-2.2-i2v-spicy — only the model field changes; 2.2 is more affordable, takes a last frame and has no audio
• Result files are deleted after 30 days; download or re-host them in time
• Charged only on success