Kling V3 视频生成

model = kling-v3·¥0.63/秒

异步处理模式：提交后立即返回 task_id，再轮询任务接口
统一视频接口 POST /api/v1/videos/generations
通过 resolution 控制：720p / 1080p / 4k
时长 3–15 秒
参考图最多 1 张（URL / base64）
渠道：标准渠道 · 售价 ¥0.63/秒 · 失败自动退款

POST /api/v1/videos/generations

模型页试一试 →

标准渠道

本模型为标准（经济）路由。同族若存在「官方渠道」条目，可在左侧目录展开切换。

模型 ID

请求体 model 必须为 kling-v3。

简介

可灵 V3；支持 4K

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer cr_你的API_Key

Base URL：https://xiaoguai123.xyz

Body

模型名称

固定填写 kling-v3

视频生成的文本描述

支持中英文，建议详细描述
可能触发内容安全策略，违规会直接报错

视频时长（秒）

按秒计费模型：金额 ≈ 单价 × 秒数
必须在允许范围内
整数范围：3–15
默认：5

使用场景示例

文生视频（最简）

{
  "model": "kling-v3",
  "prompt": "镜头缓缓推进，瀑布与彩虹，自然光"
}

带默认参数的完整示例

{
  "model": "kling-v3",
  "prompt": "镜头缓缓推进，瀑布与彩虹，自然光",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

图生视频

{
  "model": "kling-v3",
  "prompt": "让画面中的主体缓缓移动",
  "image_urls": [
    "https://example.com/ref.jpg"
  ],
  "duration": 5
}

Response

提交成功时返回任务数组：

status：如 submitted（已提交）
task_id：任务唯一标识，用于后续查询

查询任务结果

GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer cr_你的API_Key

• 提交：POST https://xiaoguai123.xyz/api/v1/videos/generations

• 查询：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

• status=completed 时读取 result.images / result.videos；failed 已自动退款

详见任务查询接口。

状态	含义
pending / submitted	已提交或排队
processing	上游处理中
completed	成功，result 可用
failed	失败，已自动退款

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/videos/generations \
  -H "Authorization: Bearer cr_你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "kling-v3", "prompt": "镜头缓缓推进，瀑布与彩虹，自然光", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9" }'

RESPONSE

成功提交

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "xg_01hxyz..."
    }
  ]
}