Omni-Video
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
请求参数
Header 参数
Content-Type
string
可选
示例: application/json
Authorization
string
可选
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
model_name
string
必需
模型名称 枚举值：kling-video-o1 kling-v3-omni
multi_shot
boolean
必需
是否生成多镜头视频 当前参数为true时，prompt参数无效 当前参数为false时，shot_type参数及multi_prompt参数无效
shot_type
string
可选
分镜方式 枚举值：customize 当multi_shot参数为true时，当前参数必填
prompt
string
可选
文本提示词，可包含正向描述和负向描述 可将提示词模板化来满足不同的视频生成需求 不能超过2500个字符 当multi_shot参数为false，当前参数不得为空
multi_prompt
array [object]
可选
各分镜信息，如提示词、时长等 ● 通过index、prompt、duration参数定义分镜序号及相应提示词和时长，其中： ○ 最多支持6个分镜，最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长，不小于1 ○ 所有分镜的时长之和等于当前任务的总时长
sound
string
可选
生成视频时是否同时生成声音 枚举值：on，off
image_list
array [object]
可选
参考图列表 包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频；当作为首帧或尾帧生成视频时： 通过type参数来定义图片是否为首尾帧：first_frame为首帧，end_frame为尾帧 暂时不支持仅尾帧，即有尾帧图时必须有首帧图 首帧或首尾帧生视频时，不能使用视频编辑功能
video_list
array [object]
可选
参考视频，通过URL方式获取 可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声 通过refer_type参数区分参考视频类型：feature为特征参考视频，base为待编辑视频 参考视频为待编辑视频时，不能定义视频首尾帧 通过keep_original_sound参数选择是否保留视频原声，yes为保留，no为不保留；当前参数对特征参考视频（feature）也生效
element_list
array [object]
可选
主体
mode
string
必需
生成视频的模式 枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高 其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
aspect_ratio
string
可选
生成视频的画面纵横比（宽:高） 枚举值：16:9, 9:16, 1:1 未使用首帧参考或视频编辑功能时，当前参数必填
duration
string
必需
生成视频时长，单位s 枚举值：3，4，5，6，7，8，9，10，其中： 使用文生视频、首帧图生视频时，仅支持5和10s 使用视频编辑功能（"refer_type":"base"）时，输出结果与传入视频时长相同，此时当前参数无效；此时，按输入视频时长四舍五入取整计量计费 kling-v3-omni 支持 ● 枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15
watermark_info
object
可选
是否同时生成含水印的结果 ● 通过enabled参数定义，用key:value承载，如下：："watermark_info": { "enabled": boolean // true 为生成，false 为不生成 }
callback_url
string
可选
external_task_id
string
可选
示例
{
"model_name": "kling-video-o1",
"prompt": "生成一个海边有一个人跳舞的视频",
"negative_prompt": "",
"mode": "std",
"element_list": [{"element_id": 835266081714884677}],
"aspect_ratio": "16:9",
"duration": "5",
"callback_url": "",
"external_task_id": ""
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/kling/v1/videos/omni-video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"model_name": "kling-video-o1",
"prompt": "生成一个海边有一个人跳舞的视频",
"negative_prompt": "",
"mode": "std",
"element_list": [{"element_id": 835266081714884677}],
"aspect_ratio": "16:9",
"duration": "5",
"callback_url": "",
"external_task_id": ""
}'var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
var raw = JSON.stringify({
"model_name": "kling-video-o1",
"prompt": "生成一个海边有一个人跳舞的视频",
"negative_prompt": "",
"mode": "std",
"element_list": [{"element_id": 835266081714884677}],
"aspect_ratio": "16:9",
"duration": "5",
"callback_url": "",
"external_task_id": ""
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/kling/v1/videos/omni-video", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"model_name": "kling-video-o1",
"prompt": "生成一个海边有一个人跳舞的视频",
"negative_prompt": "",
"mode": "std",
"element_list": [{"element_id": 835266081714884677}],
"aspect_ratio": "16:9",
"duration": "5",
"callback_url": "",
"external_task_id": ""
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
}
conn.request("POST", "/kling/v1/videos/omni-video", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))返回响应
响应参数 application/json
object
string
可选
示例
{}