Kling 任务 API 集成与使用指南

简介

Kling 任务 API 的主要功能是通过输入由 Kling 视频生成 API 生成的任务 ID 来查询任务的执行状态。本文将详细介绍 Kling 任务 API 的集成步骤，帮助您轻松整合并充分利用该 API 的强大功能。通过 Kling 任务 API，您可以便捷地查询从 Kling 视频生成 API 获取的任务执行状态。

环境准备/前置条件

在开始使用 Kling 任务 API 之前，您需要在 Kling 视频生成 API 的申请页面申请相应的服务，并从 Kling 视频生成 API 中复制任务 ID，如下图所示：

接下来，访问 Kling 任务 API 页面申请相应的服务。在页面中点击“获取”按钮，如下图所示：

如果您尚未登录或注册，系统会自动重定向到 登录页面，邀请您进行注册和登录。登录或注册后，您会自动返回当前页面。

首次申请用户可获得免费的配额，允许您免费使用该 API。

详细步骤

请求示例

Kling 任务 API 可用于查询 Kling 视频生成 API 的结果。有关如何使用 Kling 视频生成 API 的信息，请参阅文档 Kling 视频生成 API。

我们将以 Kling 视频生成 API 返回的任务 ID 为例，假设我们有一个任务 ID：20068983-0cc9-4c6a-aeb6-9c6a3c668be0，接下来演示如何传入该任务 ID。

设置请求头和请求体

请求头包括：

• accept：指定响应格式为 JSON，设置为application/json。
• authorization：调用 API 的 API 密钥，申请后可从下拉菜单中选择。

请求体包括：

• id：上传的任务 ID。
• action：任务的操作方法。

设置方式如下图所示：

代码示例

页面右侧会自动生成不同语言的代码示例，如下图所示：

以下是一些代码示例：

CURL

curl -X POST 'https://api.acedata.cloud/kling/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0", "action": "retrieve" }'

Python

import requests url = "https://api.acedata.cloud/kling/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0", "action": "retrieve" } response = requests.post(url, json=payload, headers=headers) print(response.text)

响应示例

请求成功后，API 将返回视频任务的详细信息。例如：

{ "_id": "67c5163f550a4144a5b68698", "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0", ... }

返回结果包含多个字段，其中request字段是任务启动时的请求体，而response字段是任务完成后返回的响应体。

批量查询操作

此功能用于查询多个任务 ID 的视频任务详情，与单个查询不同，操作需要选择retrieve_batch。

请求体包括：

• ids：上传任务 ID 的数组。
• action：任务的操作方法。

设置方式如下图所示：

响应示例

请求成功后，API 将返回所有批量视频任务的具体详情。例如：

{ "items": [ { "_id": "67c5163f550a4144a5b68698", "id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0", ... }, ... ], "count": 2 }

错误处理

调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。例如：

• 400 token_mismatched：请求错误，可能由于缺少或无效的参数。
• 401 invalid_token：未经授权，API 密钥无效或缺失。
• 429 too_many_requests：请求过多，超出速率限制。
• 500 api_error：服务器内部错误。

错误响应示例

{ "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" }

总结

通过本文，您已经了解了如何使用 Kling 任务 API 查询单个或批量视频任务的具体细节。希望本文能帮助您更好地集成和使用该 API。如有任何问题，请随时联系技术支持团队。

技术标签

• API 集成
• 视频生成
• Python 编程
• 错误处理
• Ace Data Cloud