CokeAPI
视频生成系列

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_listmetadata.element_listvideo_list

模型 ID: kling-v3-omni

调用示例

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "prompt": "一只橘猫在雪地中奔跑,电影级画面,超高清",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'
curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-omni",
    "prompt": "让<<<image_1>>>中的人物转身面向镜头挥手,背景以<<<video_1>>>为参考",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9",
    "video_list": [
      {
        "video_url": "https://cdn.cokeapi.com/uploads/2026/05/17/ref-video.mp4",
        "refer_type": "base",
        "keep_original_sound": "no"
      }
    ],
    "metadata": {
      "image_list": [
        { "image_url": "https://cdn.cokeapi.com/uploads/2026/05/17/photo.png" }
      ],
      "element_list": [
        {
          "url": "https://cdn.cokeapi.com/uploads/2026/05/17/person.png",
          "type": "character",
          "role": "<<<element_1>>>"
        }
      ]
    }
  }'
TASK_ID="01HX..."
curl https://cokeapi.com/v1/generations/$TASK_ID \
  -H "Authorization: Bearer sk-xxxxxxxx"
import httpx, time

BASE = "https://cokeapi.com/v1"
HEADERS = {"Authorization": "Bearer sk-xxxxxxxx"}

r = httpx.post(
    f"{BASE}/video/generations",
    headers=HEADERS,
    json={
        "model": "kling-v3-omni",
        "prompt": "一只橘猫在雪地中奔跑,电影级画面",
        "mode": "pro",
        "duration": 5,
        "aspect_ratio": "16:9",
    },
    timeout=60,
)
task_id = r.json()["id"]

while True:
    r = httpx.get(f"{BASE}/generations/{task_id}", headers=HEADERS, timeout=30)
    data = r.json()
    if data["status"] in ("succeeded", "failed", "refunded"):
        print(data)
        break
    time.sleep(5)
const BASE = "https://cokeapi.com/v1";
const KEY = process.env.COKEAPI_KEY;

const create = await fetch(`${BASE}/video/generations`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "kling-v3-omni",
    prompt: "一只橘猫在雪地中奔跑,电影级画面",
    mode: "pro",
    duration: 5,
    aspect_ratio: "16:9",
  }),
});
const { id: taskId } = await create.json();

while (true) {
  const poll = await fetch(`${BASE}/generations/${taskId}`, {
    headers: { "Authorization": `Bearer ${KEY}` },
  });
  const data = await poll.json();
  if (["succeeded", "failed", "refunded"].includes(data.status)) {
    console.log(data);
    break;
  }
  await new Promise((r) => setTimeout(r, 5000));
}

请求参数

参数类型必填默认值说明
modelstringkling-v3-omni
promptstring视频提示词,支持 <<<image_N>>> / <<<video_N>>> / <<<element_N>>> 占位符引用
client_business_idstring客户侧业务 ID,可用于查询状态
modestringstdstd(720p) / pro(1080p)
durationint5视频时长(秒): 3-15
aspect_ratiostring16:916:9 / 9:16 / 1:1
image_urlsstring[]参考图 URL 列表 (图生视频)
video_listobject[]参考视频列表,每项含 video_url/refer_type/keep_original_sound
audioboolfalse是否生成有声视频。与 video_list 互斥
watermarkboolfalse是否添加水印
seedint随机种子,可复现结果
metadataobject扩展字段,见下方说明

video_list 格式

[
  {
    "video_url": "https://example.com/source-video.mp4",
    "refer_type": "base",
    "keep_original_sound": "no"
  }
]
字段类型说明
video_urlstring参考视频 URL,必须公网可访问
refer_typestringbase(待编辑视频) / feature(特征参考视频)
keep_original_soundstringyes / no

metadata 字段

参数类型说明
metadata.image_listobject[]Omni 图片列表,每项含 image_url 和可选 type(first_frame/end_frame)
metadata.element_listobject[]Omni 主体/角色引用,每项含 url/type/role
metadata.watermarkbool是否添加水印

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>>>"
  }
]
字段类型说明
urlstring元素图片 URL
typestringcharacter(角色) / object(物体)
rolestringprompt 中对应的占位符,如 <<<element_1>>>

分辨率档位

mode16:99:161:1
std (720p)1280x720720x1280720x720
pro (1080p)1920x10801080x19201080x1080

响应

创建任务 (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_listaudio 互斥,不可同时使用
  • duration 支持 3-15 秒
  • 失败的任务不计费,会自动返还预扣点数

本页目录