Wan2.5 Text to Video

Generate high-quality videos from text descriptions using the wan2.5-t2v-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 Text-to-Video

{
  "model": "wan2.5-t2v-preview",
  "task_type": "video",
  "input": {
    "prompt": "A futuristic city with flying cars and neon lights",
    "size": "1280*720",
    "duration": 5
  }
}

With Prompt Enhancement

{
  "model": "wan2.5-t2v-preview",
  "task_type": "video",
  "input": {
    "prompt": "A peaceful garden in spring",
    "size": "1920*1080",
    "duration": 10,
    "prompt_extend": true
  }
}

Important Notes

Prompt Enhancement: Enable prompt_extend: true to automatically optimize your prompt for better results 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 Length: Maximum 1500 characters Processing Time: Typically 1-5 minutes Video Expiration: 24 hours, download promptly