Alibaba Wan 2.7 Image To Video API Documentation

Alibaba Wan 2.7 Image To Video API Documentation

Playground

WAN 2.7 converts images into videos (720p/1080p) with optional audio, supporting first and last frame control. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

Wan 2.7 Image-to-Video animates a reference image into a high-quality cinematic video clip. Upload a start frame, optionally provide an end frame for guided transitions, and describe the motion — the model generates smooth, natural video with optional audio synchronization and precise prompt control.

• Need to generate from text only? Try Wan 2.7 Text-to-Video

Why Choose This?

• Image-grounded generation Start from a reference photo for precise visual control over subject appearance, environment, and composition.

• Start and end frame guidance Provide both a starting image and an end frame to define exactly where the clip begins and finishes.

• Audio input support Upload an audio track to guide the rhythm, mood, and pacing of the generated video.

• Negative prompt support Specify what you don’t want in the video for more precise control over the output.

• Prompt expansion Enable enable_prompt_expansion to let the model automatically enrich and optimize your prompt before generation.

• Resolution options Generate at 720p or 1080p to match your delivery requirements.

• Reproducible results Use the seed parameter to lock in a specific output for exact reproduction.

Parameters

How to Use

1. Upload your image — provide the start frame to animate via URL or drag-and-drop.
2. Write your prompt — describe the motion, camera movement, and scene atmosphere. Use the Prompt Enhancer for better results.
3. Upload last image (optional) — provide an end frame to guide where the clip finishes.
4. Upload audio (optional) — provide an audio file or URL to synchronize the video.
5. Add negative prompt (optional) — specify elements you want to exclude from the output.
6. Select resolution — 720p for standard output, 1080p for higher-quality results.
7. Set duration — choose your desired clip length in seconds.
8. Enable prompt expansion (optional) — let the model automatically enrich your prompt before generation.
9. Set seed (optional) — fix the seed to reproduce a specific result in future runs.
10. Submit — generate, preview, and download your video.

Pricing

Billing Rules

• 720p: $0.10 per second
• 1080p: $0.15 per second (1.5× base rate)

Best Use Cases

• Photo Animation — Bring portraits, landscapes, and lifestyle photos to life with natural cinematic motion.
• Scene Transitions — Use start and end frames for smooth, controlled visual transitions.
• Social Media Content — Animate reference images into short-form clips for Reels, TikTok, and Shorts.
• Marketing & Advertising — Animate product and campaign images for promotional video content.
• Music & Audio-Visual — Synchronize animated footage to a music track or voiceover.

Pro Tips

• Use a high-quality, well-lit reference image with a clearly visible subject for the most natural animation.
• Providing a last_image significantly improves motion direction and narrative coherence.
• Use negative_prompt to avoid common artifacts like unwanted motion or blurry faces.
• Enable prompt expansion for shorter or less detailed prompts to get richer output automatically.
• Fix the seed once you find a result you like to iterate consistently across resolution and duration changes.

Notes

• Both image and prompt are required fields; all other parameters are optional.
• Ensure image and audio URLs are publicly accessible if using links rather than direct uploads.
• Please ensure your content complies with usage policies.

Related Models

• Wan 2.7 Text-to-Video — Generate video from text prompts without a reference image.

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": "720p",
  "duration": 5,
  "enable_prompt_expansion": false,
  "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.7/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