Skip to main content
Kling 系列通过 AIOAGI 视频任务接口调用。图生视频使用 POST /videos/image2video,Omni 视频使用 POST /videos/omni-video。任务创建后,你需要使用对应的 GET 接口轮询任务结果。
Kling 模型名称、价格、时长、模式、音频支持和任务状态字段可能变化。生产调用前,请在 控制台GET /models开发者指南 中核对当前可用模型。

接口概览

图生视频示例

提交成功后,响应通常包含 task_id。请保存该 ID,用于后续查询。

查询图生视频结果

任务状态常见值包括 submittedprocessingsucceedfailed。不同线路也可能返回 queuedrunningsucceededcompleted

Omni 视频示例

Omni 视频支持多图输入 image_list。你可以在 prompt 中使用 <<<image_1>>><<<image_2>>> 引用对应图片。

查询 Omni 视频结果

成功后,视频 URL 可能出现在 data.task_result.videos[]output.video_urloutput.watermark_video_urlmetadata.url 或兼容字段中。请以实际响应结构为准,并在服务端记录原始响应。

核心参数

Python 轮询示例

下面的示例展示如何轮询图生视频任务。Omni 视频只需要把查询路径改为 /videos/omni-video/{task_id}

排障建议

  • 遇到 401,检查 API Key 和 Authorization 请求头。
  • 遇到 403,检查账户余额、Token 组额度和模型权限。
  • 遇到 404,核对 base URL、接口路径、模型名和 task_id
  • 遇到 429,降低提交并发和轮询频率,并加入指数退避。
  • 任务成功但没有解析到 URL 时,保存原始响应,检查 dataoutputmetadata 中的视频字段。