Alibaba Wan 3.0 Prime Image To Video Spicy API Documentation

Alibaba Wan 3.0 Prime Image To Video Spicy API Documentation

Playground

Wan 3.0 Prime Spicy Image to Video is an accelerated variant that animates a first-frame image into a cinematic video, with optional last-frame guidance, flexible 2-30 second duration, aspect ratio control, optional audio, and deep-thinking controls for high-quality motion and scene continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Wan 3.0 Prime Spicy Image-to-Video animates a first-frame image into a coherent video with optional last-frame guidance and audio generation. It uses the input image as the visual starting point while adding prompt-guided motion, camera movement, and scene progression.

Why Choose This?

• Image-to-video generation
  Animate a first-frame image into a complete video.

• Optional last-frame guidance
  Use last_image to guide the ending frame and create more controlled start-to-end motion.

• Prompt-guided motion
  Describe subject action, camera movement, scene progression, lighting, and mood.

• Flexible resolution options
  Choose 480p, 720p, or 1080p depending on cost and output quality needs.

• Audio generation
  Keep enable_audio enabled when audio should be included in the generated video.

• Prompt expansion
  Enable enable_prompt_expansion when you want the prompt optimizer to expand the original instruction.

Parameters

How to Use

1. Upload a first-frame image — Provide the image that should define the starting frame and composition.
2. Write a prompt optional — Describe the desired action, motion, camera movement, lighting, mood, and scene progression.
3. Add a last image optional — Use last_image when you want stronger control over the ending frame.
4. Choose resolution — Select 480p, 720p, or 1080p.
5. Choose aspect ratio optional — Select a supported ratio or leave it empty to adapt to the input image.
6. Set duration — Choose a video length from 2 to 30 seconds.
7. Configure prompt expansion optional — Enable enable_prompt_expansion when you want the prompt optimized automatically.
8. Configure audio optional — Keep enable_audio enabled when audio is needed.
9. Set seed optional — Use a fixed seed for reproducible results, or -1 for random generation.
10. Submit — Generate the final image-to-video output.

Pricing

Pricing is based on selected resolution and billed duration.

Billed duration is rounded up to the next whole second and clamped to the 2–30s range.

Example Costs

last_image, aspect_ratio, enable_prompt_expansion, enable_audio, and seed do not add separate charges.

Best Use Cases

• Image animation — Turn still images into short motion clips.
• Character motion — Animate portraits, characters, or illustrated subjects.
• Start-and-end-frame generation — Use image and last_image to guide both the beginning and ending of the video.
• Product and marketing videos — Animate product shots, campaign visuals, and promotional images.
• Creative prototyping — Test motion, camera direction, and scene progression from a fixed first frame.
• Social video content — Create short-form videos from static images for different layouts.

Pro Tips

• Use a clear, high-quality first-frame image for stronger subject and composition consistency.
• Use last_image when the final pose, framing, or scene state matters.
• Describe visible action clearly instead of only describing visual style.
• Include camera movement, lighting, mood, and scene progression when they matter.
• Use 480p for lower-cost testing and 1080p for higher-resolution output.
• Enable enable_prompt_expansion when the original prompt is short or needs more detail.
• Set a fixed seed when comparing prompt or parameter changes.

Notes

• image is the only required parameter.
• duration supports values from 2 to 30 seconds.
• If aspect_ratio is omitted, the output adapts to the input image.
• last_image is optional and provides ending-frame guidance.
• enable_audio defaults to true.
• enable_prompt_expansion defaults to false.

Related Models

• Wan 3.0 Prime Image-to-Video — Animate a first-frame image with the standard Prime image-to-video workflow.
• Wan 3.0 Image-to-Video — Generate videos from a first-frame image with optional last-frame guidance.
• Wan 3.0 Reference-to-Video — Generate videos using reference images, videos, or audio for multimodal guidance.

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'
{
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "duration": 5,
  "enable_prompt_expansion": false,
  "enable_audio": true
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-3.0-prime/image-to-video-spicy" \
  -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="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 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|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters