OneLinkAI API 调用文档
OneLinkAI 官网模型广场
OneLinkAI 官网模型广场
  1. API文档
  • 使用指南
    • 产品简介
    • 快速开始
    • API文档
      • 模型接入指南
      • 获取模型列表
      • 大语言会话模型接入
      • Vidu 系列模型接入
      • Kling 系列模型接入
      • Veo 模型接入
      • Nano Banana 模型接入
      • GPT Image 2 模型接入
      • 大语言会话模型接口
        • Embeddings 接入
        • Rerank 接入
        • OpenAI
        • OpenAI-Responses
        • Claude
        • Gemini
      • Seedance 模型接入
        • 火山方舟模型接入指南
        • Seedance2.0 真人人像素材使用
        • Seedance 2.0 私域虚拟人像素材使用
        • 真人人像素材接口
          • 1-创建真人认证H5链接
          • 2-使用BytedToken获取GroupId
          • 3-上传素材URL创建Asset
          • 4-查询素材状态
          • 5-查询素材列表 (可选)
          • 6-删除素材 (可选)
          • 7-删除素材组 (可选)
      • HappyHorse 模型接入
        • HappyHorse 文生视频
        • HappyHorse 图生视频-基于首帧
        • HappyHorse 参考生视频
        • HappyHorse 视频编辑
    • 组织功能使用文档
      • 团队记忆
  • 开发工具
    • CC-Switch使用
    • Claude Code
    • Codex
    • Gemini
    • Hermes
    • WorkBuddy
    • OpenCode
    • OpenClaw
    • Trae Code
    • Trae Work
    • DeepSeek Harness
    • Cherry Studio
  • 更新日志
    • 产品更新日志
    • Desk 产品更新日志
  • 关于我们
    • 商务合作
    • 联系我们
  • 服务条款
    • 用户协议
    • 隐私政策
    • 用户充值协议
    • 申请账号主体变更协议
    • 合作伙伴服务协议
  • 合作指南
    • 合作伙伴规则
  • OLA cloud使用指南
    • 快速开始
    • 容器实例
      • 概述
      • JupyterLab
      • SSH远程连接
      • 升降配置
      • 转换计费方式
      • 守护进程
    • 最佳实践
      • Linux 基础
      • Cmder
      • XShell
      • MobaXterm
      • VSCode
      • PyCharm
    • 常见问题
      • 不能调用GPU
      • 常见问题
      • 为什么导入的用户在批量创建实例时选不到？
    • 数据
      • 概述
      • 公开数据
  1. API文档

Kling 系列模型接入

文档版本：2026-09-08

概览#

OneLinkAI 提供 Kling 平台兼容接口，用于在 OneLinkAI 网关下调用 Kling 相关能力。整体目标是尽可能兼容 Kling 官方协议，方便已经接入 Kling 官方接口的业务快速迁移或并行接入。
Kling 官方当前主版本已经升级到 Kling 3.0。与旧版接口相比，3.0 不只是新增模型名称，还调整了请求路径、请求体结构和任务查询方式：
视频生成使用能力与模型版本组合路径，例如 /text-to-video/kling-3.0。
请求体按 prompt、contents、settings、options 分组。
Kling 3.0 Turbo 使用统一的 /tasks 接口查询任务。
图像生成接口新增 kling-v3，图像 Omni 新增 kling-v3-omni。
官方能力目录新增或升级了主体管理、音色管理、文生音效、视频生音效和语音合成。
本文将“官方当前能力”和“OneLinkAI 网关支持状态”分开描述。只有经过 OneLinkAI 网关联调的能力才能标记为“已确认”；不能仅根据 Kling 官方上线情况推断网关已经支持。

接入规则#

鉴权方式#

调用 OneLinkAI 的 Kling 平台兼容接口时，统一使用 Bearer Token 鉴权：

路径规则#

旧版 Kling 兼容接口统一挂载在 /kling/v1 前缀下。
示例：
官方旧版路径：/v1/videos/text2video
OneLinkAI 路径：/kling/v1/videos/text2video
官方旧版路径：/v1/images/generations
OneLinkAI 路径：/kling/v1/images/generations
Kling 3.0 官方使用新的版本化能力路径。OneLinkAI 若按现有网关规则透传，建议映射如下；上线前必须以 OneLinkAI 实际路由配置为准：
能力Kling 官方路径OneLinkAI 建议路径
Kling 3.0 文生视频/text-to-video/kling-3.0/kling/v1/text-to-video/kling-3.0
Kling 3.0 图生视频/image-to-video/kling-3.0/kling/v1/image-to-video/kling-3.0
Kling 3.0 Omni 视频/omni-video/kling-3.0-omni/kling/v1/omni-video/kling-3.0-omni
Kling 3.0 动作控制/motion-control/kling-3.0/kling/v1/motion-control/kling-3.0
Kling 3.0 Turbo 文生视频/text-to-video/kling-3.0-turbo/kling/v1/text-to-video/kling-3.0-turbo
Kling 3.0 Turbo 图生视频/image-to-video/kling-3.0-turbo/kling/v1/image-to-video/kling-3.0-turbo
Kling 3.0 任务查询/tasks/kling/v1/tasks
注意：上表中的 OneLinkAI 3.0 路径是按现有前缀规则整理的目标映射，不代表网关已经上线。发布前应逐条完成创建、查询和回调联调。

通用调用方式#

创建类接口返回任务信息，核心标识通常为 data.task_id。
成功响应通常包含 code、message、request_id 和 data。
旧版接口一般通过对应创建路径追加 /{task_id} 查询单个任务。
Kling 3.0 Turbo 官方通过 /tasks?external_task_ids=... 查询任务，也支持 POST /tasks 批量查询。
配置 callback_url 后，服务端会在任务状态变化时发送回调。
未配置回调时，业务侧应持久化任务标识，并采用退避策略轮询任务状态。
URL 或 Base64 媒体输入的格式、大小、时长及有效期限制，应以对应官方能力页面为准。

接口详情#

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址。请替换为真实接入地址和有效的 ApiKey。

Kling 3.0 视频模型 API#

文生视频#

Kling 官方路径：/text-to-video/kling-3.0
OneLinkAI 建议路径：/kling/v1/text-to-video/kling-3.0
主要结构：prompt + settings + options

图生视频#

Kling 官方路径：/image-to-video/kling-3.0
OneLinkAI 建议路径：/kling/v1/image-to-video/kling-3.0
主要结构：contents + settings + options

视频 Omni#

Kling 官方路径：/omni-video/kling-3.0-omni
OneLinkAI 建议路径：/kling/v1/omni-video/kling-3.0-omni
可通过 contents 组合提示词、图片、主体、视频及其他参考输入。

动作控制#

Kling 官方路径：/motion-control/kling-3.0
OneLinkAI 建议路径：/kling/v1/motion-control/kling-3.0
contents 中分别提供提示词、外观参考图和动作参考视频。

Kling 3.0 Turbo#

Turbo 版本使用相同的分组结构，但路径中的模型版本为 kling-3.0-turbo。官方示例支持 3 秒、720p 等配置，具体可选值以接口页面为准。

查询 Kling 3.0 任务#

Kling 3.0 Turbo 官方文档使用统一任务接口。OneLinkAI 若实现该协议，建议保留同样的查询参数和请求体。

图像模型 API#

图像生成#

官方 /v1/images/generations 路径保持不变，当前 model_name 枚举已经包含 kling-v3。旧文档只示例了 kling-v2-1，不是当前最新模型。
查询单个任务：

图像 Omni#

官方 /v1/images/omni-image 路径保持不变，当前支持 kling-image-o1 和 kling-v3-omni。

现有兼容接口#

以下接口在原文中已经标记为 OneLinkAI 支持，可继续保留。其模型可选值、媒体限制和字段约束应以相应官方版本页面为准。
能力创建路径单任务查询路径
旧版文生视频/kling/v1/videos/text2video/kling/v1/videos/text2video/{task_id}
旧版图生视频/kling/v1/videos/image2video/kling/v1/videos/image2video/{task_id}
多图参考生视频/kling/v1/videos/multi-image2video/kling/v1/videos/multi-image2video/{task_id}
多模态视频编辑/kling/v1/videos/multi-elements/kling/v1/videos/multi-elements/{task_id}
视频延长/kling/v1/videos/video-extend/kling/v1/videos/video-extend/{task_id}
对口型
/kling/v1/videos/advanced-lip-sync/kling/v1/videos/advanced-lip-sync/{task_id}
数字人/kling/v1/videos/avatar/image2video/kling/v1/videos/avatar/image2video/{task_id}
多图参考生图/kling/v1/images/multi-image2image/kling/v1/images/multi-image2image/{task_id}
扩图/kling/v1/images/editing/expand/kling/v1/images/editing/expand/{task_id}
智能补全主体图/kling/v1/general/ai-multi-shot/kling/v1/general/ai-multi-shot/{task_id}

迁移检查清单#

从旧版兼容接口迁移至 Kling 3.0 时，不要只替换 model_name。至少检查以下内容：
1.
路径是否从 /videos/text2video 一类旧路径切换为版本化能力路径。
2.
请求体是否改为 prompt、contents、settings、options 分组。
3.
duration 在 3.0 示例中为数字，而旧文档示例使用字符串。
4.
图生视频的输入是否改为 contents 中的 first_frame，而不是顶层 image。
5.
音频选项是否使用当前接口允许的值，例如 off、native、original；不同能力的枚举并不完全相同。
6.
是否正确处理 /tasks 查询、回调签名、幂等标识和任务状态。
7.
OneLinkAI 网关是否已经实现新路径透传、字段校验、计费映射及返回结构转换。

使用建议#

新项目优先评估 Kling 3.0 或 Kling 3.0 Turbo；已有项目可继续使用旧接口，避免无必要的协议迁移。
首次联调应先验证一个创建请求，确认返回 data.task_id 或对应任务标识。
随后验证查询、失败状态、超时、回调重试和结果 URL 过期处理，完成异步任务闭环。
external_task_id 应在单个租户或账号范围内保持唯一，便于幂等处理和任务追踪。
不要把本文中的“建议路径”直接视为生产可用地址；应以 OneLinkAI 实际发布的路由和支持清单为准。

参考来源#

1.
Kling AI API 官方文档导航
2.
Kling 3.0 文生视频
3.
Kling 3.0 图生视频
4.
Kling 3.0 Omni 视频
5.
Kling 3.0 动作控制
6.
Kling Image 3.0 图像生成
7.
Kling Image 3.0 Omni
核对说明：本文基于 2026-09-08 可访问的 Kling AI 官方线上文档及其随页面发布的 API schema 整理。
修改于 2026-09-18 01:55:45
上一页
Vidu 系列模型接入
下一页
Veo 模型接入
Built with