Wan2.5 Image to Video

Convert images to high-quality dynamic videos using the wan2.5-i2v-preview model.

API Endpoint

Create Video Generation Task

post

Create an asynchronous video generation task, returns task_id for subsequent queries.

Model Selection:

• Text-to-Video (T2V): Use wan2.2-t2v-plus or wan2.5-t2v-preview, no img_url required
• Image-to-Video (I2V): Use wan2.2-i2v-flash, wan2.2-i2v-plus, or wan2.5-i2v-preview, img_url required

Authorizations

BearerAuth

AuthorizationstringRequired

Authenticate using Bearer Token.

Get API Key: Visit ViralAPI Console

Body

application/json

modelstring · enumRequired

Model name, supported options:

• wan2.2-t2v-plus: Text-to-Video v2.2 (fixed 5s, no audio)
• wan2.2-i2v-flash: Image-to-Video v2.2 Flash (480P/720P, fixed 5s)
• wan2.2-i2v-plus: Image-to-Video v2.2 Plus (480P/1080P, fixed 5s)
• wan2.5-t2v-preview: Text-to-Video v2.5 (prompt enhancement, 5/10s, audio)
• wan2.5-i2v-preview: Image-to-Video v2.5 (higher quality, 5/10s, audio)

Possible values:

task_typestring · enumRequired

Task type, must be set to video

Possible values:

Responses

200

Task created successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

402

Insufficient account balance

application/json

500

Internal server error

application/json

post

/v1/task/create

HTTPcURLJavaScriptPython

POST /v1/task/create HTTP/1.1
Host: viralapi.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 157

{
  "model": "wan2.2-t2v-plus",
  "task_type": "video",
  "input": {
    "prompt": "A serene mountain landscape at sunset with flowing clouds",
    "size": "1280*720",
    "duration": 5
  }
}

Wan2.2 Text-to-VideoWan2.2 Image-to-Video FlashWan2.5 Text-to-VideoWan2.5 Image-to-Video

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "task_tongyi_wanxiang_1765178625768"
  }
}

Usage Examples

Basic Image-to-Video

{
  "model": "wan2.5-i2v-preview",
  "task_type": "video",
  "input": {
    "prompt": "The city comes alive with movement and energy",
    "img_url": "https://example.com/city-scene.jpg",
    "resolution": "1080P",
    "duration": 5
  }
}

Advanced Motion Control

{
  "model": "wan2.5-i2v-preview",
  "task_type": "video",
  "input": {
    "prompt": "Camera slowly pans right while the character turns and smiles",
    "img_url": "https://example.com/portrait.jpg",
    "resolution": "1080P",
    "duration": 10,
    "shot_type": "multi"
  }
}

Image Requirements

• Resolution: 360-2000 pixels

• File Size: ≤10MB

• Format: JPG, PNG, WebP

• Recommendation: Use clear, well-composed images for best results

Important Notes

Duration Options: Choose 5 or 10 seconds, defaults to 5 seconds Audio Support: Generates videos with audio by default (auto-dubbing), customize via audio_url Prompt Tip: Describe motion style and rhythm specifically, e.g., "camera slowly pans right while character gradually turns" Processing Time: Typically 1-5 minutes Video Expiration: 24 hours, download promptly