Skip to main content
AlibabaSlowUltra

Wan 2.5 I2V

Image-to-video model with lip sync support, animating still images into realistic videos with natural motion.

1500 credits
per video
Image-to-video animation
Lip sync support
Natural motion from still images
High-quality output
Seed control for reproducibility

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txt

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "wan-video/wan-2.5-i2v",
  "input": {
    "prompt": "Person slowly smiling and turning their head to the left, gentle hair movement, natural facial expression transition",
    "image_url": "https://example.com/portrait.jpg",
    "aspect_ratio": "9:16",
    "duration": 5
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text description of the desired motion and animation
image_urlstringYes-Start frame image URL to animate
aspect_ratiostringNo16:9Output aspect ratio
durationintegerNo5Video duration in seconds
seedintegerNo-Random seed for reproducibility

How to Provide File Input

There are 3 ways to provide files for the image_url parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=wan-video/wan-2.5-i2v" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_url=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "wan-video/wan-2.5-i2v",
  "input": {
    "prompt": "your prompt here",
    "image_url": "https://example.com/image.jpg"
  }
}
See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Portrait Animation

Animate a portrait photo

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "wan-video/wan-2.5-i2v",
  "input": {
    "prompt": "Person slowly smiling and turning their head to the left, gentle hair movement, natural facial expression transition",
    "image_url": "https://example.com/portrait.jpg",
    "aspect_ratio": "9:16",
    "duration": 5
  }
}'

Product Come to Life

Animate a product image

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "wan-video/wan-2.5-i2v",
  "input": {
    "prompt": "Camera slowly orbits around the product, soft studio lighting reveals details, subtle reflections",
    "image_url": "https://example.com/product.jpg",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}'

Tips & Best Practices

1Provide a high-quality source image for the best animation results
2Describe the desired motion clearly in the prompt
3Use lip sync capability for talking head videos
4The aspect ratio should match your source image for best results

Use Cases

Photo animation
Character lip sync videos
Product image animation
Portrait animation
Visual storytelling from stills