视频生成系列
Kling v3 Omni
快手 Kling v3 Omni 视频生成,支持视频参考(video_list)和 Omni 引用语法,720p/1080p、3-15 秒。
CokeAPI 接入快手 Kling v3 Omni 视频模型。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 succeeded。
文件上传提示:生成接口不再接收内联 base64 图片/视频数据。请先使用 文件上传接口 上传参考图片或视频获取 URL,再传入 metadata.image_list、metadata.element_list 或 video_list。
模型 ID: kling-v3-omni
调用示例
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | — | kling-v3-omni |
| prompt | string | 是 | — | 视频提示词,支持 <<<image_N>>> / <<<video_N>>> / <<<element_N>>> 占位符引用 |
| client_business_id | string | 否 | — | 客户侧业务 ID,可用于查询状态 |
| mode | string | 否 | std | std(720p) / pro(1080p) |
| duration | int | 否 | 5 | 视频时长(秒): 3-15 |
| aspect_ratio | string | 否 | 16:9 | 16:9 / 9:16 / 1:1 |
| image_urls | string[] | 否 | — | 参考图 URL 列表 (图生视频) |
| video_list | object[] | 否 | — | 参考视频列表,每项含 video_url/refer_type/keep_original_sound |
| audio | bool | 否 | false | 是否生成有声视频。与 video_list 互斥 |
| watermark | bool | 否 | false | 是否添加水印 |
| seed | int | 否 | — | 随机种子,可复现结果 |
| metadata | object | 否 | — | 扩展字段,见下方说明 |
video_list 格式
[
{
"video_url": "https://example.com/source-video.mp4",
"refer_type": "base",
"keep_original_sound": "no"
}
]| 字段 | 类型 | 说明 |
|---|---|---|
| video_url | string | 参考视频 URL,必须公网可访问 |
| refer_type | string | base(待编辑视频) / feature(特征参考视频) |
| keep_original_sound | string | yes / no |
metadata 字段
| 参数 | 类型 | 说明 |
|---|---|---|
| metadata.image_list | object[] | Omni 图片列表,每项含 image_url 和可选 type(first_frame/end_frame) |
| metadata.element_list | object[] | Omni 主体/角色引用,每项含 url/type/role |
| metadata.watermark | bool | 是否添加水印 |
metadata.image_list 格式
[
{ "image_url": "https://example.com/photo.png", "type": "first_frame" }
]type 可选 first_frame(首帧) 或 end_frame(末帧),不填则作为普通参考图。
metadata.element_list 格式
[
{
"url": "https://example.com/person.png",
"type": "character",
"role": "<<<element_1>>>"
}
]| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | 元素图片 URL |
| type | string | character(角色) / object(物体) |
| role | string | prompt 中对应的占位符,如 <<<element_1>>> |
分辨率档位
| mode | 16:9 | 9:16 | 1:1 |
|---|---|---|---|
std (720p) | 1280x720 | 720x1280 | 720x720 |
pro (1080p) | 1920x1080 | 1080x1920 | 1080x1080 |
响应
创建任务 (POST)
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"status": "queued",
"progress": 0,
"model": "kling-v3-omni",
"kind": "video",
"mode": "text_to_video",
"created": 1768380224
}查询任务 (GET /v1/generations/{task_id})
进行中:
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"status": "running",
"progress": 45,
"model": "kling-v3-omni",
"kind": "video",
"mode": "text_to_video",
"created": 1768380224
}完成后:
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"status": "succeeded",
"progress": 100,
"model": "kling-v3-omni",
"kind": "video",
"mode": "text_to_video",
"result": {
"id": "video_abc123def456",
"object": "video.generation",
"created": 1768380224,
"model": "kling-v3-omni",
"data": [
{
"url": "https://cdn.cokeapi.com/v/video_abc123def456.mp4",
"duration_ms": 5000,
"width": 1920,
"height": 1080
}
]
},
"created": 1768380224
}任务状态说明
| 状态 | 说明 |
|---|---|
| queued | 任务已排队等待处理 |
| running | 任务正在处理中 |
| succeeded | 任务已完成 |
| failed | 任务失败 |
| refunded | 任务失败已退款 |
计费
按 6 秒基准档计费,超过 6 秒按 10 秒档计费(费用 = 基准价 × 10/6)。
| 分辨率 | 6 秒基准价 | 10 秒价 |
|---|---|---|
| 720p | $0.096 | $0.16 |
| 1080p | $0.128 | $0.213 |
失败任务不计费,自动退款。价格为 2026-07 快照,以 模型列表页 实时价目为准。
注意事项
- 图生视频/视频参考请先通过 文件上传接口 上传文件获取 URL
- Omni 引用语法: 在 prompt 中使用
<<<image_1>>>、<<<video_1>>>、<<<element_1>>>占位符引用已上传的媒体 video_list与audio互斥,不可同时使用duration支持 3-15 秒- 失败的任务不计费,会自动返还预扣点数