mingyanmingyan
mingyan

LuxVid Video - 创建任务

使用 LuxVid Video 创建视频生成任务,支持参考图片、参考视频、参考音频以及首帧或尾帧输入

POST/kyyReactApiServer/v1/luxvid-video/videos

LuxVid Video 创建视频任务

使用 LuxVid_video_fastLuxVid_video 创建视频生成任务。该接口支持参考图片、参考视频、参考音频,也支持仅传首帧图片或尾帧图片生成视频。

认证

所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

模型介绍

模型说明
LuxVid_video_fastfast 版本
LuxVid_video满血版

请求参数

modelbodystring必填
模型名称。可选值:LuxVid_video_fastLuxVid_video
promptbodystring必填
视频生成提示词,最多 1500 个字符。支持在提示词中使用 @图片1@视频1@音频1 等引用参考素材。
durationbodyinteger
视频时长,单位秒。默认 5,支持范围 1-15
ratiobodystring
输出画面比例,默认 16:9。可选值:1:13:44:39:1616:921:9
resolutionbodystring
输出分辨率,默认 720p。当前仅支持 720p
first_imagebodystring
首帧图片 URL。传入 first_imagelast_image 任一字段时,接口自动使用首尾帧模式。
不能与 referenceImagesreferenceVideosreferenceAudios 同时使用。
last_imagebodystring
尾帧图片 URL。可以单独传入,也可以与 first_image 一起传入。
不能与 referenceImagesreferenceVideosreferenceAudios 同时使用。
referenceImagesbodyarray
参考图片 URL 列表,最多 9 张。每张图片大小不能超过 20MB
referenceVideosbodyarray
参考视频 URL 列表,最多 3 条,总时长不能超过 15 秒。单个参考素材分辨率需在 720px-2160px 之间。
referenceAudiosbodyarray
参考音频 URL 列表,最多 3 条,总时长不能超过 15 秒。

参数规则

模式互斥:
  • 传入 first_imagelast_image 时,按首尾帧模式提交。
  • 未传首尾帧字段时,按参考素材模式提交。
  • 首尾帧模式不能与 referenceImagesreferenceVideosreferenceAudios 混用。

响应参数

idstring
视频生成任务 ID,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
使用的模型名称。
statusstring
任务状态,创建后通常为 queued
errorstring
错误信息,失败时返回。