LogoKling 3 API

Kling 3.0 API 文档

将 Kling 3.0 和 Kling Video O3 API 集成到您应用程序的完整指南。

API v1.0 Base URL: https://kling3api.com

快速开始

bash
curl -X POST 'https://kling3api.com/api/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "pro-text-to-video",
    "prompt": "A cinematic shot of mountains at sunrise",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

身份认证

所有 API 请求都需要在 Authorization 头中使用 Bearer 令牌进行身份验证。

获取 API 密钥: 您可以在控制面板的 API Keys 页面获取您的 API 密钥。

http
Authorization: Bearer YOUR_API_KEY

可用模型

3.0

Kling 3.0

高质量 4K 视频生成

类型描述时长积分
pro-text-to-videoPro 品质文生视频5s / 10s240 / 480
pro-image-to-videoPro 品质图生视频5s / 10s240 / 480
std-text-to-video标准品质文生视频5s / 10s180 / 360
std-image-to-video标准品质图生视频5s / 10s180 / 360
O3

Kling Video O3

支持参考图/视频编辑的新一代模型

类型描述时长积分
o3-pro-text-to-videoO3 Pro 文生视频3-15s48/s
o3-pro-image-to-videoO3 Pro 图生视频3-15s48/s
o3-pro-reference-to-videoO3 Pro 参考图/视频生成3-15s72/s
o3-pro-video-editO3 Pro 视频编辑auto435 fixed
o3-std-text-to-videoO3 标准 文生视频3-15s36/s
o3-std-image-to-videoO3 标准 图生视频3-15s36/s
o3-std-reference-to-videoO3 标准 参考生成3-15s20/s
o3-std-video-editO3 标准 视频编辑auto360 fixed

API 端点

POST/api/generate
创建新的视频生成任务。API 会根据任务类型自动路由到正确的后端。

请求体

Parameter类型必填描述
typestring必填任务类型（如 pro-text-to-video, o3-pro-reference-to-video）
promptstring必填视频描述文本（最多 2000 字符）
durationnumber可选视频时长（秒）。Kling 3.0: 5 或 10。O3: 3-15。 (默认值: 5)
aspect_ratiostring可选输出宽高比（16:9, 9:16, 1:1） (默认值: 16:9)
imagestring可选图生视频任务的图片 URL
end_imagestring可选结束帧图片 URL（仅限图生视频）
videostring可选参考视频或视频编辑任务的视频 URL
imagesstring[]可选参考图片 URL 数组（O3 参考生成，最多 7 张）
soundboolean可选启用原生音频生成 (默认值: false)
negative_promptstring可选负面提示词，避免生成某些元素
cfg_scalenumber可选提示词遵循度（0-1，仅限 Kling 3.0） (默认值: 0.5)

Kling 3.0 - 文生视频

json
{
  "type": "pro-text-to-video",
  "prompt": "A majestic eagle soaring through clouds at sunset",
  "duration": 5,
  "aspect_ratio": "16:9",
  "sound": true
}

Kling 3.0 - 图生视频

json
{
  "type": "pro-image-to-video",
  "prompt": "The character slowly turns and smiles",
  "image": "https://example.com/my-image.jpg",
  "duration": 5
}

Kling O3 - 参考生成

json
{
  "type": "o3-pro-reference-to-video",
  "prompt": "The character walks through a futuristic city",
  "images": [
    "https://example.com/character-reference.jpg",
    "https://example.com/style-reference.jpg"
  ],
  "duration": 5,
  "aspect_ratio": "16:9"
}

Kling O3 - 视频编辑

json
{
  "type": "o3-pro-video-edit",
  "prompt": "Change the background to a snowy mountain landscape",
  "video": "https://example.com/original-video.mp4",
  "keep_original_sound": true
}

响应

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n70abc123kling3",
    "status": "IN_PROGRESS",
    "consumed_credits": 240
  }
}
GET/api/status

API 测试工具

直接在浏览器中测试 API。将 YOUR_API_KEY 替换为您的实际 API 密钥。

API 测试沙盒POST

错误代码

StatusCodeDescription
400 错误请求INVALID_PROMPT提示词无效或为空
400 错误请求INVALID_DURATION时长超出支持范围
400 错误请求INVALID_TYPE不支持的任务类型
400 错误请求MISSING_IMAGE图生视频任务需要提供图片
400 错误请求MISSING_VIDEO视频编辑任务需要提供视频
401 未授权INVALID_API_KEYAPI 密钥缺失或无效
402 INSUFFICIENT_CREDITS积分不足
429 请求过多RATE_LIMITED请求过于频繁，请稍后再试
500 服务器内部错误INTERNAL_ERROR服务器错误，请稍后重试