Kling 4.0kling-4.ai 帮助文档
Kling 4.0kling-4.ai 帮助文档
首页

快速开始

概览

API 参考

API 概览身份验证生成视频查询与列出任务模型错误与额度
X
API 参考

身份验证

申请 API 访问,并使用 x-api-key 请求头验证请求。

获取 API 密钥

API 密钥访问在 v1 阶段逐步开放。浏览器生成器使用手动领取的免费积分,并在提交前显示费用。如需服务端 API 访问,请联系我们,说明使用场景和预计生成量。

收到密钥后,请妥善保存。像保护密码一样保护它:不要将密钥放进前端代码、公开仓库、共享截图或分析工具中。

使用密钥

每次请求都在 x-api-key 请求头中携带密钥:

curl 'https://kling-4.ai/api/ai-video/jobs' \
  -H 'x-api-key: YOUR_API_KEY'
const res = await fetch('https://kling-4.ai/api/ai-video/jobs', {
  headers: { 'x-api-key': process.env.KLING_API_KEY! },
});
const { jobs } = await res.json();

使用有效密钥验证的请求代表获批工作区。创建的任务归属于该密钥,并消耗分配给它的额度。

不带密钥的请求仍可在浏览器环境下使用,这是免费网页生成器通过访客 Cookie 服务游客的方式。但服务端集成应始终使用 API 密钥:访客身份依赖 Cookie,无法在不同机器间自动延续。

保护密钥

  • 从你的服务器调用 API,不要从浏览器代码直接调用,任何能读取前端代码包的人都可能提取其中的密钥。
  • 将密钥保存在环境变量 KLING_API_KEY 中,不要提交到版本控制。
  • 如怀疑密钥泄露,请联系我们,以便更换密钥。

API 概览

通过一个密钥访问可灵模型,使用 HTTP 异步生成视频,并获取 CDN 托管的结果。

生成视频

POST /api/ai-video/jobs:通过文本提示词创建生成任务,支持参考图、音频和尾帧控制。

目录

获取 API 密钥
使用密钥
保护密钥