mingyan

LuxVid Video - Create Task

Create LuxVid Video generation tasks with reference images, videos, audios, and optional first or last frame input

POST/kyyReactApiServer/v1/luxvid-video/videos

LuxVid Video Create Task

Create a video generation task with LuxVid_video_fast or LuxVid_video. The API supports reference images, reference videos, reference audios, and first-frame or last-frame input.

Authentication

Get Key

All requests require a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Models

Model	Description
`LuxVid_video_fast`	Fast version
`LuxVid_video`	Full version

Request Parameters

modelbodystringrequired

Model name. Available values: LuxVid_video_fast, LuxVid_video.

promptbodystringrequired

Video generation prompt. Maximum length is 1500 characters. You can reference materials with tokens such as @图片1, @视频1, and @音频1.

durationbodyinteger

Video duration in seconds. Defaults to 5. Supported range: 1-15.

ratiobodystring

Output aspect ratio. Defaults to 16:9. Available values: 1:1, 3:4, 4:3, 9:16, 16:9, 21:9.

resolutionbodystring

Output resolution. Defaults to 720p. Currently only 720p is supported.

first_imagebodystring

First frame image URL. When either first_image or last_image is provided, the request is submitted in frame mode.

Cannot be used together with referenceImages, referenceVideos, or referenceAudios.

last_imagebodystring

Last frame image URL. It can be provided alone or together with first_image.

Cannot be used together with referenceImages, referenceVideos, or referenceAudios.

referenceImagesbodyarray

Reference image URL list. Up to 9 images. Each image must not exceed 20MB.

referenceVideosbodyarray

Reference video URL list. Up to 3 videos. Total duration must not exceed 15 seconds. Each reference material resolution must be between 720px and 2160px.

referenceAudiosbodyarray

Reference audio URL list. Up to 3 audios. Total duration must not exceed 15 seconds.

Rules

Mode exclusivity:

Providing first_image or last_image uses frame mode.
If no frame field is provided, reference material mode is used.
Frame mode cannot be combined with referenceImages, referenceVideos, or referenceAudios.

Response Parameters

idstring

Video generation task ID for status queries.

objectstring

Object type, always video.

createdinteger

Task creation timestamp.

modelstring

Model name used for generation.

statusstring

Task status, usually queued after creation.

errorstring

Error message when the request fails.