Wan 2.7 Image to Video Pro API

Wan 2.7 Image-to-Video Pro

Wan 2.7 Image-to-Video Pro is the premium image-to-video model, transforming still images into cinematic video with superior motion quality and detail. Upload a reference image, describe the scene and motion — the model generates smooth, high-resolution video with optional audio input and flexible duration options.

Why Choose This?

Pro-tier quality Superior visual fidelity and motion realism from the latest Wan 2.7 architecture.
Multiple resolutions Output in 1080p, 2K, or 4K to match your production needs.
Audio support Optional audio input for synchronized video generation.
Shot type control Choose between single or multi-shot compositions.
Prompt Enhancer Built-in prompt optimizer for improved generation results.
Negative prompt support Specify elements to exclude for more precise control.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the desired scene and motion
image	Yes	Reference image to animate (URL or upload)
audio	No	Audio file for synchronized video (URL or upload)
negative_prompt	No	Elements to exclude from the video
resolution	No	Output resolution: 1080p (default), 2k, 4k
duration	No	Video length in seconds (default: 5)
shot_type	No	Shot composition: single (default) or multi
enable_prompt_expansion	No	Enable prompt optimizer (default: disabled)
seed	No	Random seed for reproducibility (-1 for random)

How to Use

Upload your image — provide the reference image to animate.
Write your prompt — describe the scene, motion, camera movement, and mood in detail.
Add audio (optional) — upload audio for synchronized video generation.
Add negative prompt (optional) — specify elements you want to avoid.
Choose resolution — select 1080p, 2K, or 4K based on your needs.
Set duration — choose the desired video length.
Select shot type — single for focused shots, multi for complex compositions.
Enable prompt expansion (optional) — let the optimizer enhance your prompt.
Run — submit and download your video.

Pricing

Duration	1080p	2k	4k
5 s	$0.60	$0.70	$0.80
10 s	$1.20	$1.40	$1.60
15 s	$1.80	$2.10	$2.40

Billing Rules

Base rate (1080p): $0.60 per 5 seconds
2K rate: $0.70 per 5 seconds
4K rate: $0.80 per 5 seconds

Best Use Cases

Premium Production — High-resolution video requiring superior visual quality.
Marketing & Ads — Cinematic promotional videos with professional polish.
Music Videos — Synchronized video generation with audio input.
E-commerce — Bring product images to life in stunning detail.
Content Creation — Create engaging short-form videos for social media.

Pro Tips

Use detailed, cinematic prompts for best results — include lighting, camera angles, and motion descriptions.
Try the Prompt Enhancer (enable_prompt_expansion) to automatically refine your descriptions.
Use negative_prompt to avoid common issues like blurry faces or unwanted elements.
Add audio for music videos or content requiring synchronized sound.
Use single shot_type for focused character or product animations, multi for complex scene compositions.
Set a specific seed for reproducible results across multiple generations.

Notes

Both prompt and image are required fields.
Ensure uploaded image and audio URLs are publicly accessible.
Higher resolutions (2K, 4K) produce better detail but cost more.

Related Models

Wan 2.7 Text-to-Video — Generate videos from text prompts.
Wan 2.7 Image-to-Video — Standard tier image-to-video at lower cost.
Wan 2.6 Image-to-Video Pro — Previous-generation Pro tier.

Wan 2.7 Image To Video Pro API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/alibaba/wan-2.7/image-to-video-pro with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Wan 2.7 Image To Video Pro below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.7/image-to-video-pro" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "resolution": "1080p",
    "duration": 5,
    "shot_type": "single",
    "enable_prompt_expansion": false,
    "seed": -1
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("alibaba/wan-2.7/image-to-video-pro", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "resolution": "1080p",
        "duration": 5,
        "shot_type": "single",
        "enable_prompt_expansion": false,
        "seed": -1
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "alibaba/wan-2.7/image-to-video-pro",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "resolution": "1080p",
    "duration": 5,
    "shot_type": "single",
    "enable_prompt_expansion": false,
    "seed": -1
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Wan 2.7 Image To Video Pro API — Frequently asked questions

What is the Wan 2.7 Image To Video Pro API?

Wan 2.7 Image To Video Pro is a Alibaba model for video generation from images, exposed as a REST API on WaveSpeedAI. Wan 2.7 Image to Video Pro is a fast AI image-to-video generation model that converts images into premium-quality videos with superior motion dynamics, enhanced visual fidelity, and professional cinematic output. Ready-to-use REST inference API for product videos, advertising creatives, cinematic clips, social media content, character animation, visual storytelling, and professional image-to-video workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Wan 2.7 Image To Video Pro API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/alibaba/alibaba-wan-2.7-image-to-video-pro.

How much does Wan 2.7 Image To Video Pro cost per run?

Wan 2.7 Image To Video Pro starts at $0.60 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Wan 2.7 Image To Video Pro accept?

Key inputs: `prompt`, `image`, `audio`, `resolution`, `duration`, `seed`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/alibaba/alibaba-wan-2.7-image-to-video-pro.

How do I get started with the Wan 2.7 Image To Video Pro API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Wan 2.7 Image To Video Pro outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Alibaba). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

サンプルすべて表示

関連モデル

README