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中,不要提交到版本控制。 - 如怀疑密钥泄露,请联系我们,以便更换密钥。