打开链接? 目标地址
继续前往
开发文档

Kling V3 与 O3:首尾帧和源视频参考

接入预告 · 待上线。以下为计划兼容的请求格式。请在 UiUiAPI 为你的令牌开放对应模型、并标明支持本页接口后再调用;实际上线的模型名、限制和价格以平台为准。

V3 适合按首尾帧控制转场,O3 可用多张参考图或源视频约束主体与动作。

模式与参数

型号 时长与清晰度 参考方式
kling-v3 5–15 秒,720P 首帧和尾帧各 1 张,也可纯文本
kling-o3 5–15 秒,720P、1080P 或 2160P 最多 7 张普通参考图;带 1 个源视频时最多 4 张普通参考图

提交任务

先在终端设置环境变量 UIUI_API_KEY。以下示例使用主站的 JSON 接口。含 example.com 的素材地址需要换成服务器能读取的 HTTPS 文件地址。

curl -sS --fail-with-body 'https://api.uiuihao.com/v1/videos' \
  -H "Authorization: Bearer $UIUI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "kling-v3",
  "prompt": "从入口镜头平稳移动到展厅中央。",
  "seconds": 8,
  "size": "1280x720",
  "start_frame": "https://example.com/ref.jpg",
  "end_frame": "https://example.com/last.jpg"
}'

用 O3 参考源视频

{
  "model": "kling-o3",
  "prompt": "保留源视频的镜头节奏,将主体改成参考图中的产品。",
  "seconds": 8,
  "size": "1920x1080",
  "input_video": "https://example.com/source.mp4",
  "reference_images": [
    "https://example.com/ref.jpg"
  ]
}

提供尾帧时也需提供首帧。audio 控制结果是否带音轨。横屏、方形和竖屏分别使用与 16:9、1:1、9:16 对应的尺寸。

查询进度与保存视频

从提交响应读取 id 或 task_id。在终端设置 TASK_ID 为返回的原值,再查询状态。

curl -sS --fail-with-body "https://api.uiuihao.com/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $UIUI_API_KEY"

排队或生成中时隔几秒再查询;收到 429 时按 Retry-After 延长间隔。遇到 failed / FAILURE 时停止轮询并查看错误。成功状态如 completed / SUCCESS 出现后,可用同一任务 ID 保存成片。

curl -fSL "https://api.uiuihao.com/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $UIUI_API_KEY" -o output.mp4

若返回临时成片链接,及时保存。向外部存储下载时无需附带 UiUiAPI 密钥。超时先查任务记录,避免重复生成。