Wan 2.1 I2V 480p API Documentation

Wan 2.1 I2V 480p API Documentation

Playground

Wan 2.1 i2v-480p turns images into unlimited 480p AI videos with the Wan 2.1 image-to-video model, perfect for fast content creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

wavespeed-ai/wan-2.1/i2v-480p animates a single image into a short, smooth 480p video clip with natural motion, stable framing, and strong prompt control—ideal for fast I2V iteration and lightweight production previews.

What it’s good at

• Turning a still image into a 5–10s video with coherent motion
• Subtle, natural gestures (talking-to-camera, nods, hand movement)
• Smooth camera feel (gentle push-in, slight handheld, slow pan) without over-shaking
• Quick story beats for ads, explainers, and social clips at 480p

Playground inputs

• Image (required): the source frame to animate
• Prompt (required): describe subject, action, environment, and camera
• Negative prompt (optional): reduce blur, jitter, artifacts, unwanted styles
• Size: 480p
• Duration: 5s or 10s

Prompting guide for natural I2V

Write like a director’s brief:

• Subject: who is in frame
• Action: what they do (small, realistic verbs work best)
• Environment: lighting + background
• Camera: framing + motion style
• Motion quality: smooth, natural, stable

Example prompt (talking head / business): A confident young tech professional standing in a modern office, talking to the camera with calm hand gestures. Soft daylight, clean environment, business casual outfit, focused expression. Center frame, smooth motion, natural micro-expressions.

Negative prompt suggestions: blurry, jittery, shaky camera, low quality, distorted face, warped hands, inconsistent motion

Use cases

• Product demos: bring a hero image to life with subtle motion and camera polish
• Corporate explainers: talking-to-camera clips from a portrait-style photo
• Social ads: quick 5-second motion posts for faster iteration
• Concept validation: test prompts and motion direction cheaply before higher resolutions

Pricing

Notes

• For the most stable faces, keep actions subtle (talk, nod, small gestures) and avoid extreme head turns.
• If motion looks too “busy,” describe a calmer camera style (locked-off, slow push-in, gentle handheld).
• If details smear, add stronger constraints in the prompt (center frame, steady, smooth motion) and use a negative prompt that targets blur/jitter.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "size": "832*480",
  "num_inference_steps": 30,
  "duration": 5,
  "guidance_scale": 5,
  "flow_shift": 3,
  "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/wan-2.1/i2v-480p" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters