典名词元DMTOKENSHome
API DocumentationThird-Party Tools Tutorial
AI Model APIVideoVidu

Text-to-Video VQ1/VQ2/VQ3P

POST/api/v1/video/generation

Header Parameters

Authorization*string

Format: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

Fixed value t2v

model*string

Model names, supported: viduq1 viduq2 viduq3-pro

Value in"viduq1" | "viduq2" | "viduq3-pro"
prompt*string

Generated prompt text

duration*integer

Video duration in seconds, supported values: viduq1: fixed at 5; viduq2: supports 1-8; viduq3-pro: default 5, supports 1-16.

resolution*string

Resolution: viduq1 supports 1080p; viduq2 supports 360p / 540p / 720p / 1080p; viduq3-pro defaults to 720p, supports 540p / 720p / 1080p.

style?string

Style, only supported by viduq1, default is general, supported: general, anime.

movementAmplitude?string

Motion amplitude, only supported by viduq1, default auto, supported: auto, small, medium, large.

seed?integer

Random Seed

aspectRatio?string

Aspect ratio, default 16:9, supported: 16:9, 9:16, 1:1. viduq2/viduq3-pro additionally supports 3:4, 4:3.

bgm?string

Whether to enable background music, default false

audio?boolean

Whether to use the direct audio and video output capability, defaults to true (only supported by viduq3-pro)

Response Body

application/json

Success

TypeScript Definitions

Use the response body type in TypeScript.

code*integer

Status Code

data*object

Data Object

urls*array<string>

Result Set

[]?string
usage*object

Usage Information

images*integer

Number of Images

seconds*integer

Video Duration in Seconds

input_tokens*integer

Input Token Count

total_tokens*integer

Total Tokens

output_tokens*integer

Output Token Count

expired*string

Validity Period

task_id*string

Task ID

task_status*string

Task Status

message*string

Status Information

request_id*string

Request ID

curl -X POST "https://api.ygw.ai/api/v1/video/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "_action": "t2v",    "model": "viduq1",    "prompt": "string",    "duration": 0,    "resolution": "string"  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}