Skip to Content
Video ModelsWAN 3 Fast

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_00000000000000000000000000000000

Endpoints

1. Create Task

Request

POST https://api.pixwithapi.online/api/task/create

Headers

HeaderValueRequired
Content-Typeapplication/jsonYes
Api-Key{API_KEY}Yes

Request Parameters

ParameterTypeRequiredDescription
promptstringYesThe input prompt, from 1 to 15,000 characters.
image_urlsarrayNoProvide one image for start-frame generation or two ordered images for start/end-frame generation. Omit for text-to-video.
model_idstringYes2-88
optionsobjectNoConfiguration options for the task.
options.prompt_optimizationbooleanNoAutomatically optimize and translate the prompt. Default: false.
options.aspect_ratiostringNoValid values: 'Auto', '16:9', '4:3', '1:1', '3:4', '9:16'. Default: 'Auto'.
options.resolutionstringNoValid values: '480P', '720P', '1080P'. Default: '480P'.
options.durationintNoOutput 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

ParameterTypeDescription
codeint1=success, 0=error
messagestringSuccess and failure messages
dataobjectTask data
data.task_idstringTask ID
data.estimated_timeintEstimated 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.

ParameterTypeRequiredDescription
model_idstringYes2-89.
promptstringYesGeneration prompt, 1–15,000 characters.
reference_urlsobjectYesReference media URLs; use this instead of image_urls.
reference_urls.reference_imagesarray of URLsYes1–10 reference images.
reference_urls.reference_videosarray of URLsNoUp to 5 reference videos.
reference_urls.reference_audiosarray of URLsNoUp to 5 reference audio clips.
optionsobjectNoOutput settings. Omitted fields use the defaults below.
options.prompt_optimizationbooleanNoTranslate and optimize the prompt before generation. Default: true.
options.aspect_ratiostringNoOutput aspect ratio: Auto, 16:9, 4:3, 1:1, 3:4, or 9:16. Default: Auto.
options.resolutionstringNoOutput resolution: 480P, 720P, or 1080P. Default: 480P.
options.durationintNoOutput 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