Skip to main content

你将构建的内容

你将提交一个 Kling 文生视频任务,存储返回的任务 ID,轮询对应的 Kling 任务端点,并决定何时添加 callback_url 以接收推送通知。

前置条件

  • 一个存储在 COMETAPI_KEY 中的 CometAPI API 密钥
  • 安装了 requests 的 Python 3.10+,或 Node.js 18+
  • 一个用于轮询的服务端 worker,或一个用于 webhook 的 HTTPS 回调端点

API 密钥、基础 URL、身份验证

使用以下接口创建一个 Kling 文生视频任务:
使用以下接口轮询任务:
使用 Bearer token 进行身份验证:

代码示例

使用下面的标签页查看可直接复制的 cURL、Python 和 Node.js 示例。

流程说明

Kling 视频生成是异步的。创建端点会返回一个 data.task_id。轮询 GET /kling/v1/videos/text2video/<task_id>,直到 data.task_status 变为 succeedfailed。当任务成功时,如果你需要持久访问,请将 data.task_result 中已完成资源的 URL 复制到你自己的存储中。 当你希望将任务状态更新推送到你控制的 HTTPS 端点时,请添加 callback_url。同时保留轮询机制,用于对账以及处理回调投递遗漏的情况。

常用参数

故障排查 / 常见问题

Kling 使用提供商特定的 JSON 字段,例如 data.task_iddata.task_statusdata.task_result。不要像解析 OpenAI 兼容的 /v1/videos 路由那样解析它。
使用有界轮询,并在任务失败时检查 data.task_status_msg。存储 task ID 以便后续诊断。
将轮询作为基础方案。添加 callback_url 用于推送投递,然后再通过轮询对最终状态进行核对。

后续步骤