简介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 为例假设我们有一个任务 ID20068983-0cc9-4c6a-aeb6-9c6a3c668be0接下来演示如何传入该任务 ID。设置请求头和请求体请求头包括accept指定响应格式为 JSON设置为application/json。authorization调用 API 的 API 密钥申请后可从下拉菜单中选择。请求体包括id上传的任务 ID。action任务的操作方法。设置方式如下图所示代码示例页面右侧会自动生成不同语言的代码示例如下图所示以下是一些代码示例CURLcurl -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 }Pythonimport 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, jsonpayload, headersheaders) 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