API 参考
API 概览
通过一个密钥访问可灵模型，使用 HTTP 异步生成视频，并获取 CDN 托管的结果。
工作原理
kling-4.ai API 提供一组简洁的 REST 接口，核心流程是：创建生成任务，然后轮询，直到视频就绪。
POST /api/ai-video/jobs create a generation job
GET /api/ai-video/jobs/{id} fetch one job (refreshes provider status)
GET /api/ai-video/jobs list your recent jobs
POST /api/ai-video/jobs/sync refresh all of your active jobs at once- 基础 URL：
https://kling-4.ai - 身份验证： 在
x-api-key请求头中传入获批的 API 密钥，详见身份验证。 - 格式： 输入和输出均为 JSON。
- 模型： 通过任务的
model字段选择可灵模型，详见模型。新版可灵模型正式开放后，集成时修改此字段即可切换。
快速开始
1. 获取密钥。 API 密钥访问在 v1 阶段逐步开放。如需服务端访问，请联系我们。
2. 创建任务：
curl -X POST 'https://kling-4.ai/api/ai-video/jobs' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-v2-6",
"prompt": "A cinematic sunrise over a glass city, slow drone push-in",
"parameters": {
"mode": "std",
"duration": 5,
"aspectRatio": "16:9"
}
}'响应包含你需要轮询的任务：
{
"job": {
"id": "0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41",
"model": "kling-v2-6",
"status": "queued",
"progress": 0,
"resultUrl": null,
"createdAt": "2026-07-09T03:12:45.000Z"
}
}3. 轮询直至完成：
curl 'https://kling-4.ai/api/ai-video/jobs/0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41' \
-H 'x-api-key: YOUR_API_KEY'当 status 变为 completed，任务中会包含视频文件地址 resultUrl 和缩略图地址 thumbnailUrl。生成通常需要几分钟，每隔 10–15 秒查询一次即可。注意：resultUrl 链接会过期，请检查 resultExpiresAt 并及时下载文件。
我们在 GitHub 的 awesome-kling-4 仓库中提供了可运行的 Node.js 和 Python 示例，以及经过测试的提示词库。
接口速览
| 接口 | 用途 |
|---|---|
POST /api/ai-video/jobs | 根据提示词创建生成任务，可选参考图片 |
GET /api/ai-video/jobs/{id} | 获取单个任务，并从生成流程刷新状态 |
GET /api/ai-video/jobs | 列出最近 50 个任务 |
POST /api/ai-video/jobs/sync | 一次刷新所有排队中或处理中的任务 |
额度
浏览器访客可在符合资格的 UTC 日期手动领取一次免费积分。每种受支持的生成配置都有独立显示的费用，只有可用余额足以支付服务器的权威报价时，提交才会被接受。获批的 API 密钥使用分配给工作区的积分或额度。积分不足与请求验证错误详见错误说明；如需更高生成量，请联系我们。