Kling 系列通过 AIOAGI 视频任务接口调用。图生视频使用 POST /videos/image2video,Omni 视频使用 POST /videos/omni-video。任务创建后,你需要使用对应的 GET 接口轮询任务结果。
Kling 模型名称、价格、时长、模式、音频支持和任务状态字段可能变化。生产调用前,请在 控制台、GET /models 或 开发者指南 中核对当前可用模型。
接口概览
图生视频示例
提交成功后,响应通常包含 task_id。请保存该 ID,用于后续查询。
查询图生视频结果
任务状态常见值包括 submitted、processing、succeed 和 failed。不同线路也可能返回 queued、running、succeeded 或 completed。
Omni 视频示例
Omni 视频支持多图输入 image_list。你可以在 prompt 中使用 <<<image_1>>>、<<<image_2>>> 引用对应图片。
查询 Omni 视频结果
成功后,视频 URL 可能出现在 data.task_result.videos[]、output.video_url、output.watermark_video_url、metadata.url 或兼容字段中。请以实际响应结构为准,并在服务端记录原始响应。
核心参数
Python 轮询示例
下面的示例展示如何轮询图生视频任务。Omni 视频只需要把查询路径改为 /videos/omni-video/{task_id}。
排障建议
- 遇到
401,检查 API Key 和 Authorization 请求头。
- 遇到
403,检查账户余额、Token 组额度和模型权限。
- 遇到
404,核对 base URL、接口路径、模型名和 task_id。
- 遇到
429,降低提交并发和轮询频率,并加入指数退避。
- 任务成功但没有解析到 URL 时,保存原始响应,检查
data、output、metadata 中的视频字段。