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

Single Image/First and Last Frame Video Generation VQ2PF

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: viduq2-pro-fast

resolution?string

Resolution, supported: 720p, 1080p

seed?integer

Random Seed

bgm?boolean

Whether to enable background music, defaults to false

image*object

Image Information (supported only in single image-to-video mode)

imageUrl*string

Image Link

prompt*string

Generated prompt text

duration?integer

Video duration, in seconds, supported: (Single image-to-video mode) [1,10] (First and last frame-to-video mode) [1,8]

audio?boolean

Whether to enable audio, default is false (only supported in single image-to-video mode)

voiceId?string

Voice ID (only supported in single-image-to-video mode)

headtailImages*object

First and Last Frame Image Information (supported only in First and Last Frame to Video mode)

headImage?object

First Frame Image Information

imageUrl?string

Image Link

tailImage?object

Last Frame Image Information

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 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",    "image": {      "imageUrl": "string"    },    "prompt": "string",    "headtailImages": {}  }'
{
  "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"
}