多元探索 API多元探索 API
Official Format

Vidu Text-to-Video

Use `POST /vidu/ent/v2/text2video` to submit a pure-text video generation task.

POSThttps://zx1.deepwl.net/vidu/ent/v2/text2video
Request
curl -X POST https://zx1.deepwl.net/vidu/ent/v2/text2video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -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
{
  "task_id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
  "status": "processing",
  "created_at": 1774494511
}

The official Vidu text-to-video API, submitted as application/json, supports pure-text video generation. After a successful submission, the task task_id and status are returned; use Query Task to poll for results.

Supported Models

  • viduq3-pro: Efficiently generates high-quality audio and video content, making the video more vivid, more realistic, and more three-dimensional
  • viduq2: Latest model
  • viduq1: Clear image quality, smooth transitions, and stable camera movement

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Content-Typestring必填

Request content type, must be application/json.

Request Body

modelstring必填

Model name. Supported viduq3-pro (efficiently generates high-quality audio and video content), viduq2 (latest model), viduq1 (clear image quality, smooth transitions, and stable camera movement).

stylestring

Style. general: general style; anime: anime style. Note: this parameter does not take effect when using q2 or q3 models.

promptstring必填

Text prompt. The text description for video generation, supporting Chinese and English.

durationinteger

Video duration (seconds). viduq2: default 5 seconds, optional 1-10 seconds; other models use the default value.

seedinteger

Random seed. If not provided or set to 0, a random number is used; if set manually, the specified seed is used.

aspect_ratiostring

Aspect ratio. Optional values: 16:9 (default), 9:16, 3:4, 4:3, 1:1. Note: 3:4 and 4:3 are only supported by q2 and q3 models.

resolutionstring

Resolution. The default value depends on the model and video duration. viduq2 (1-10 seconds): default 720p, optional 540p, 720p, 1080p.

bgmboolean

Whether to add background music. true: the system will automatically select suitable music from the preset BGM library and add it; false: do not add BGM. Note: the BGM parameter does not take effect when the duration of the q2 model is 9 or 10 seconds; it does not take effect in the q3 model.

audioboolean

Audio-video direct output (supported only by q3 models). true: audio-video direct output is required, outputting a video with dialogue and background sound; false: audio-video direct output is not required, outputting a silent video.

off_peakboolean

Off-peak mode. true: generate videos during off-peak periods, with lower points cost; false: generate videos immediately.

watermarkboolean

Whether to add a watermark. true: add a watermark; false: do not add a watermark. Note: the watermark content is fixed as "Content generated by AI", and it is not added by default.

wm_positioninteger

Watermark position. 1: top-left; 2: top-right; 3: bottom-right; 4: bottom-left.

wm_urlstring

Watermark image URL. If not provided, the default watermark is used.

payloadstring

Pass-through parameter. No processing is performed; data transmission only.

meta_datastring

Metadata identifier. JSON-formatted string, pass-through field.

Request Examples

Response Examples

Response Fields

task_idstring

Task ID, used to query task status.

statusstring

Task status. Optional values: processing (in progress), failed (failed), completed (completed).

created_atinteger

Creation timestamp (Unix timestamp).