Wan T2V

Wan T2V is a text-to-video generation API that transforms text prompts into high-quality, creative videos.

Features

High-Quality Video Generation: Create detailed and visually appealing videos from text descriptions
Customizable Parameters: Control video length, quality, and style with various parameters
Fast Processing: Efficient generation of videos with optimized processing times
HTTP API Access: Simple integration via RESTful API endpoints

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task

Submit a task to generate a video from text using the Wan T2V API.

curl --location --request POST 'https://api.wavespeed.ai/api/v2/wavespeed-ai/wan-2.1/t2v-720p' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "a beautiful landscape",
  "negative_prompt": "poor quality, blurry",
  "size": "1280*720",
  "num_inference_steps": 30,
  "guidance_scale": 5.0,
  "seed": -1,
  "enable_safety_checker": true
}'

Query Result

Check the status and retrieve the result of a previously submitted task.

curl --location --request GET 'https://api.wavespeed.ai/api/v2/predictions/{request_id}/result' \
--header 'Authorization: Bearer YOUR_API_KEY'

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	No	""	-	Prompt text to guide video generation
negative_prompt	string	No	""	-	Negative prompt to specify what to avoid in the video
size	string	No	”1280*720"	"1280720”, “7201280”	Video dimensions in width*height format
num_inference_steps	int	No	30	1 ~ 40	Number of inference steps
guidance_scale	float	No	5.0	0.0 ~ 10.0	Guidance scale for generation
seed	int	No	-1	-	Random seed for reproducible results. -1 for random seed
enable_safety_checker	boolean	No	true	-	Enable safety checker for generated content

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction (e.g., `wavespeed-ai/wan-2.1/t2v-480p`)
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created
data.error	string	Error message (empty if no error occurred)
data.executionTime	integer	Execution time in milliseconds

Result Query Parameters

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction
data.model	string	Model ID used for the prediction (e.g., `wavespeed-ai/wan-2.1/t2v-480p`)
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created
data.error	string	Error message (empty if no error occurred)
data.executionTime	integer	Execution time in milliseconds

video-01 wan-t2v-720p-lora