Vidu text-to-video

Submit a text-only video generation task.

POST /vidu/ent/v2/text2video

Available models

Model	Description
	Efficient high-quality audio/video generation
	Latest model
	Clear visuals, smooth transitions, stable camera

Headers

Name	Type	Required	Description
	string	Yes	Request authentication. Use a Bearer Token, for example: .
	string	Yes	Request content type; must be .

Request body

Name	Type	Required	Description
	string	Yes	Model name. See Available models above.
	string	No	Style. : general style; : anime style. Note: ignored for q2 and q3 models.
	string	Yes	Text prompt. Text description of the video to generate; Chinese and English are supported.
	integer	No	Video duration in seconds. : default 5s, range 1–10s; other models use their defaults.
	integer	No	Random seed. Omit or pass 0 for a random seed; set manually to use a fixed seed.
	string	No	Aspect ratio. Options: (default), , , , . Note: and are only supported on q2 and q3 models.
	string	No	Resolution. Default depends on model and duration. (1–10s): default 720p; options 540p, 720p, 1080p.
	boolean	No	Whether to add background music. : pick suitable music from the preset BGM library; : no BGM. Note: ignored when q2 duration is 9 or 10 seconds; ignored for q3 models.
	boolean	No	Direct audio/video output (q3 models only). : output video with dialogue and ambient audio; : silent video.
	boolean	No	Off-peak mode. : generate during off-peak hours at a lower credit cost; : generate immediately.
	boolean	No	Whether to add a watermark. : add watermark; : no watermark. Note: watermark text is fixed as "AI-generated content"; off by default.
	integer	No	Watermark position. : top-left; : top-right; : bottom-right; : bottom-left.
	string	No	Watermark image URL. Uses the default watermark when omitted.
	string	No	Passthrough parameter. Not processed; transmitted as-is.
	string	No	Metadata identifier. JSON string; passthrough field.

Request example

curl -X POST https://octopusx.ai/vidu/ent/v2/text2video \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "A cat chasing butterflies on the grass",
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "bgm": false,
  "audio": true,
  "off_peak": false,
  "watermark": false
}'

Response example

{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

Response fields

Name	Type	Description
	string	Task ID, used to query task status.
	string	Task status. Options: (in progress), (failed), (completed).
	integer	Creation timestamp (Unix timestamp).

Related endpoints

• Vidu video overview
• Video APIs overview
• Error codes