Wan 2.2 Image To Video API Documentation

Wan 2.2 Image To Video API Documentation

Playground

Wan 2.2 Image-to-Video turns a single image into smooth, cinematic motion with clean detail—ideal for storyboards, mood shots, and product demos. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

Wan 2.2 is a next-gen I2V model built on a Mixture-of-Experts denoising architecture. It turns a single still image into a smooth, cinematic short video with strong prompt adherence and stable motion.

Why it looks great

• Film-grade control: Understands lighting, color, composition, and camera language for cohesive scenes.
• Stable large motion: Handles fast subject/camera movement with fewer jitters or tears.
• Accurate semantics: Follows detailed prompts in complex, multi-object scenes.
• Pure I2V workflow: No start/end keyframes required—one reference image is enough.

Inputs & Parameters

• image (required): Reference image to lock identity, layout, and style.
• prompt (required): Scene mood, motion, and camera cues (e.g., “slow dolly-in, warm rim light”).
• negative_prompt (optional): Things to avoid (e.g., “text, watermark, distortion”).
• size: 832×480 or 1280×720.
• duration: 5 s or 8 s.
• seed: Integer; fixed for reproducibility, −1 for random.
• last_image (optional): The last frame of the video.

How to Use

1. Upload the image.
2. Add a concise prompt (subject + environment + motion + lighting).
3. Choose size (480p/720p) and duration (5 s/8 s).
4. (Optional) Set negative_prompt and seed.
5. Run and download.

Pricing

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",
  "resolution": "480p",
  "duration": 5,
  "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.2/image-to-video" \
  -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