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

Single Image/First and Last Frames/Reference Frame Video Generation V20

POST/api/v1/video/generation

Header Parameters

Authorization*string

Format: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

Fixed value i2v

model*string

Model name, supported: vidu2.0, viduq1, viduq1-classic

prompt*string

Generated prompt text

duration?integer

Video duration, in seconds, supported: 4

resolution?string

Resolution, supported: 360p, 720p, 1080p

seed?integer

Random Seed

aspectRatio?string

Aspect ratio, default 16:9, supported: 16:9, 9:16, 1:1

movementAmplitude?string

Motion amplitude, default: auto, supported: auto, small, medium, large

audio?boolean

Whether to enable audio, default false. Only supported for image-to-video.

bgm?boolean

Whether to enable background music, default is false

image?object

Image information, required for image-to-video (supported only for image-to-video)

imageUrl?string

Image Link

headtailImages?object

First and Last Frame Image Information (Only supported for video generation from first and last frames)

headImage?object

First Frame Image Information

imageUrl?string

Image Link

tailImage?object

Last Frame Image Information

imageUrl?string

Image Link

characterImages?array<object>

Reference image information, up to three images supported (only supported for reference frame videos).

[]?object
imageUrl?string

Image Link

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 Tokens

total_tokens*integer

Total Token Count

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": "string",    "model": "string",    "prompt": "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"
}