Create Text-to-Video Task

POST

/ent/v2/text2video

• Official docs: https://platform.vidu.cn/docs/text-to-video
• Create a text-to-video task and return task_id
• Control generation with model, prompt, and other parameters

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Text prompt
Text description for video generation.
Note: Must not exceed 2000 characters

Model name
Allowed values: viduq3-turbo, viduq3-pro, viduq2, viduq1

• viduq3-turbo: Faster generation than viduq3-pro
• viduq3-pro: Efficient high-quality audio-video; more vivid, expressive, dimensional output
• viduq2: Latest model
• viduq1: Clear visuals, smooth transitions, stable camera motion

Style
Default general; allowed: general, anime
general: General style; control via prompt
anime: Anime style; strong anime look; control via different anime-style prompts
Note: Not effective when using the q2 model

Video duration; default depends on model:

• viduq3-pro, viduq3-turbo: default 5s, range 1–16
• viduq2: default 5s, range 1–10
• viduq1: default 5s, allowed 5 only

Random seed
If omitted or 0, a random value is used
If set manually, that seed is used

Aspect ratio
Default 16:9; allowed: 16:9, 9:16, 3:4, 4:3, 1:1
Note: 3:4 and 4:3 only supported on q2 model

Resolution; default depends on model and duration:

• viduq3-pro, viduq3-turbo (1–16s): default 720p, allowed 540p, 720p, 1080p
• viduq2 (1–10s): default 720p, allowed 540p, 720p, 1080p
• viduq1 (5s): default 1080p, allowed 1080p

Motion amplitude
Default auto; allowed: auto, small, medium, large
Note: Not effective when using the q2 model

Whether to add background music to the generated video.
Default false; allowed true, false
If true, the system picks suitable music from the preset BGM library.

• BGM length is not limited; adapted to video duration

Passthrough parameter
Not processed; data transfer only
Note: Max 1048576 characters

Whether to add a watermark

• true: add watermark
• false: no watermark
  Note 1: Watermark content is fixed (AI-generated); off by default
  Note 2: Use watermarked_url from the query task API for watermarked video

Watermark position on the image:
1: top-left
2: top-right
3: bottom-right
4: bottom-left
Default: 3

Watermark image URL
If omitted, default watermark text: AI-generated content

Metadata identifier (JSON string), passthrough; custom or example format:
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
If empty, Vidu-generated metadata is used by default

Callback URL (POST). Set when creating the task; Vidu sends task status updates to this URL. Body matches the query task API response.
Callback status values:

• processing: in progress
• success: completed (retried up to 3 times on delivery failure)
• failed: failed (retried up to 3 times on delivery failure)
  Vidu uses callback signature authentication; see callback signature docs

Responses

Success

Content-Type

application/json

object