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

Single Image/First-Last Frame/Reference Frame to Video VQ1

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: viduq1

image?object

Image Information (Image-to-Video only)

imageUrl*string

Image Link

headtailImages?object

First and Last Frame Image Information (Only supported for first-and-last-frame video generation)

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, supporting up to seven images (only supported for reference frame-to-video generation)

[]?object
imageUrl?string

Image Link

prompt*string

Generated prompt text

duration?integer

Video duration, in seconds, supported: 5

resolution?string

Resolution, supported: 1080p

seed?integer

Random Seed

aspectRatio?string

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

movementAmplitude?string

Motion amplitude, optional, defaults to auto, supported values: auto, small, medium, large

audio?boolean

Whether to enable audio, default is false (supported only for image-to-video). false: Direct audio-video output is not required; outputs a silent video. true: Direct audio-video output is required; outputs a video with dialogue and background audio.

bgm?boolean

Whether to enable background music, default is false

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": "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"
}