WAN 3 Fast
Overview
Experience the next evolution of video generation with Wan 3.0, combining longer narratives, stronger reference consistency, precise editing, and immersive audiovisual creation for more complete visual storytelling.
Test API KEY: key_00000000000000000000000000000000Endpoints
1. Create Task
Request
POST https://api.pixwithapi.online/api/task/createHeaders
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | Yes |
| Api-Key | {API_KEY} | Yes |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | The input prompt, from 1 to 15,000 characters. |
| image_urls | array | No | Provide one image for start-frame generation or two ordered images for start/end-frame generation. Omit for text-to-video. |
| model_id | string | Yes | 2-88 |
| options | object | No | Configuration options for the task. |
| options.prompt_optimization | boolean | No | Automatically optimize and translate the prompt. Default: false. |
| options.aspect_ratio | string | No | Valid values: 'Auto', '16:9', '4:3', '1:1', '3:4', '9:16'. Default: 'Auto'. |
| options.resolution | string | No | Valid values: '480P', '720P', '1080P'. Default: '480P'. |
| options.duration | int | No | Output duration in seconds. Any integer from 2 to 30 (inclusive). Default: 5. |
Example Request - Text-to-Video
{
"prompt": "A cinematic aerial view of a mountain lake at sunrise",
"model_id": "2-88",
"options": {
"prompt_optimization": true,
"aspect_ratio": "Auto",
"resolution": "480P",
"duration": 5
}
}Example Request - Start Frame
{
"prompt": "The character turns toward the camera as the wind moves through the scene",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg"
],
"model_id": "2-88",
"options": {
"prompt_optimization": true,
"aspect_ratio": "16:9",
"resolution": "720P",
"duration": 10
}
}Example Request - Start and End Frames
{
"prompt": "Transition smoothly from the opening frame to the final frame",
"image_urls": [
"https://cdn.pixwithapi.online/images/example_start.jpeg",
"https://cdn.pixwithapi.online/images/example_end.jpeg"
],
"model_id": "2-88",
"options": {
"prompt_optimization": true,
"aspect_ratio": "9:16",
"resolution": "1080P",
"duration": 15
}
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | int | 1=success, 0=error |
| message | string | Success and failure messages |
| data | object | Task data |
| data.task_id | string | Task ID |
| data.estimated_time | int | Estimated time in seconds |
Response
{
"code": 1,
"message": "success",
"data": {
"task_id": "d425ab4dc256f0ebaa84862b9cea8a3d",
"estimated_time": 100
}
}2. Create Task With R2V
WAN 3 Fast R2V generates video from a prompt and reference media with the Fast model. Reference images define the subject and style; optional videos and audio can guide motion and sound. It supports 1–10 images, up to 5 videos, and up to 5 audio clips.
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Yes | 2-89. |
| prompt | string | Yes | Generation prompt, 1–15,000 characters. |
| reference_urls | object | Yes | Reference media URLs; use this instead of image_urls. |
| reference_urls.reference_images | array of URLs | Yes | 1–10 reference images. |
| reference_urls.reference_videos | array of URLs | No | Up to 5 reference videos. |
| reference_urls.reference_audios | array of URLs | No | Up to 5 reference audio clips. |
| options | object | No | Output settings. Omitted fields use the defaults below. |
| options.prompt_optimization | boolean | No | Translate and optimize the prompt before generation. Default: true. |
| options.aspect_ratio | string | No | Output aspect ratio: Auto, 16:9, 4:3, 1:1, 3:4, or 9:16. Default: Auto. |
| options.resolution | string | No | Output resolution: 480P, 720P, or 1080P. Default: 480P. |
| options.duration | int | No | Output duration in seconds. Any integer from 2 to 30 (inclusive). Default: 5. Total input video duration plus output duration must not exceed 30 seconds. |
{
"model_id": "2-89",
"prompt": "Keep the subject consistent while following the reference motion",
"reference_urls": {
"reference_images": ["https://media.example.com/character.webp"],
"reference_videos": ["https://media.example.com/motion.mp4"],
"reference_audios": []
},
"options": {
"prompt_optimization": true,
"aspect_ratio": "Auto",
"resolution": "720P",
"duration": 10
}
}Response
{"code":1,"message":"success","data":{"task_id":"d425ab4dc256f0ebaa84862b9cea8a3d"}}Last updated on