Kling 视频生成 API 集成指南

本文将介绍如何集成 Kling 视频生成 API，该 API 可以通过输入自定义参数生成官方的 Kling 视频。Kling 视频生成 API 非常适合需要快速生成视频内容的开发者和创作者，广泛应用于广告、自媒体内容制作等场景。

环境准备

在使用 API 之前，您需要完成以下步骤：

注册并登录 Ace Data Cloud。
申请 Kling 视频生成 API 服务。

详细步骤

申请使用 API

首先，访问 Kling 视频生成 API 页面，点击"获取"按钮，如下图所示：

如果您尚未登录或注册，将自动重定向到登录页面。登录后，您将返回到申请页面。首次申请时，您可以免费使用该 API。

基本用法

使用该 API 的基本方法如下：

您需要输入以下参数：

prompt: 视频生成的提示内容。
action: 动作类型，主要包括 text2video（文本转视频）、image2video（图像转视频）和 extend（视频扩展）。
start_image_url: 起始帧参考图像的 URL。
model: 选择生成视频的模型。

当前支持的模型包括 kling-v1、kling-v1-6、kling-v2-master、kling-v2-1-master、kling-v2-5-turbo 和 kling-video-o1，如图所示：

接下来，设置请求头，包括：

accept: 希望接收的响应格式，填写为 application/json。
authorization: 调用 API 的密钥。

请求体应包含以下内容：

json 复制代码

{
  "model": "kling-v1",
  "mode": "std",
  "action": "text2video",
  "start_image_url": "https://example.com/start_image.jpg",
  "aspect_ratio": "16:9",
  "prompt": "描述视频内容的提示",
  "callback_url": "https://your.callback.url"
}

点击"尝试"按钮进行测试，您将获得如下结果：

json 复制代码

{
  "success": true,
  "video_id": "af9a1af0-9aa0-4638-81c1-d41d6143c508",
  "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7485378259/text2video/Cjil4mfBfs0AAAAAAKbMQQ-0_raw_video_1.mp4",
  "duration": "5.1",
  "state": "succeed",
  "task_id": "e3a575aa-a4bd-49c8-9b12-cde38d5462e0"
}

视频扩展功能

如果您想继续生成已创建的 Kling 视频，请将参数 action 设置为 extend，并输入要继续生成的视频 ID。视频 ID 可在基础用法中获得。

json 复制代码

{
  "action": "extend",
  "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
  "prompt": "新的提示内容",
  "duration": 10
}

异步回调

由于 Kling 视频生成 API 生成时间较长（约 1-2 分钟），可以使用异步回调功能。您需要在请求中指定 callback_url 字段。任务完成后，结果将以 POST JSON 形式发送到指定的回调 URL。

例如，您可以使用 Webhook.site 创建一个测试 webhook。

设置 callback_url 后，点击运行，您将立即获得 task_id：

json 复制代码

{
  "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}

后续结果将发送到您指定的回调 URL。

错误处理

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

json 复制代码

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

总结

通过本文，您学习了如何使用 Kling 视频生成 API 生成视频。希望本指南能帮助您更好地集成和使用该 API。如有任何问题，请随时联系技术支持团队。

技术标签：#KlingAPI #视频生成 #AceDataCloud #API集成 #异步回调