API 参考
查询与列出任务
获取单个任务、列出近期任务或刷新全部活跃任务，并了解任务如何从排队进入完成状态。
任务生命周期
每个任务会经历以下状态：
| 状态 | 含义 |
|---|---|
queued | 已受理，等待可用的生成资源。 |
processing | 正在生成，progress 从 0 增长到 100。 |
completed | 已完成，resultUrl 和 thumbnailUrl 已设置。 |
failed | 发生错误，原因见 errorMessage。 |
cancelled | 任务在完成前已取消。 |
获取单个任务
GET /api/ai-video/jobs/{id}curl 'https://kling-4.ai/api/ai-video/jobs/0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41' \
-H 'x-api-key: YOUR_API_KEY'返回 { "job": … }，结构与创建任务相同。此接口每次调用都会从生成流程刷新任务状态，因此应使用它进行轮询。通常每隔 10–15 秒查询一次即可，生成一般需要几分钟。
不存在或属于其他用户的任务 ID 会返回 404 JOB_NOT_FOUND。
列出你的任务
GET /api/ai-video/jobscurl 'https://kling-4.ai/api/ai-video/jobs' \
-H 'x-api-key: YOUR_API_KEY'返回 { "jobs": [...] }，包含你最近 50 个任务，按时间倒序排列。此接口只读取数据库，不会访问生成流程，因此调用成本较低，但仍在生成的任务可能尚未反映最新状态。
同步全部活跃任务
POST /api/ai-video/jobs/synccurl -X POST 'https://kling-4.ai/api/ai-video/jobs/sync' \
-H 'x-api-key: YOUR_API_KEY'一次调用即可从生成流程刷新你所有排队中或处理中的任务，并返回更新后的列表。适用于应用离线后重新打开、无需逐个任务轮询的场景。
结果链接会过期
resultUrl 指向我们的 CDN，但链接有时间限制，到期时间见 resultExpiresAt。应将其视为限时取件地址，而不是永久存储：
if (job.status === 'completed' && job.resultUrl) {
const video = await fetch(job.resultUrl);
await fs.promises.writeFile(`out/${job.id}.mp4`, Buffer.from(await video.arrayBuffer()));
}任务完成后，请尽快将文件下载到自己的存储中。无论是否下载，任务本身的提示词、参数与状态记录都会保留在历史记录中。