Kling AI · 概览

• 接口兼容性：/kling 前缀下的请求体、返回体与错误码与可灵官网 API 保持一致。
• 字段与示例：详细字段、取值范围、约束条件以官方文档为准。
• 主要能力：
  • 文生视频（text2video）
  • 图生视频（image2video）
  • Omni 视频（omni-video）
  • 多图参考生视频（multi-image2video）
  • 图像生成（generations）
  • Omni 图像（omni-image）
  • 多图参考生图（multi-image2image）
  • 多模态视频编辑（multi-elements）

• 采用”终态实扣，失败不扣”的异步计费模式；
• 创建任务仅落库，不对用户/Token 实际扣费；
• 当任务进入终态（成功/失败）后，由后台轮询器一次性结算，仅成功任务会扣费；
• 当上游响应包含 final_unit_deduction 时：
  • 视频按积分计费：1 积分 = 1 元
  • 图像按积分计费：1 积分 = 0.025 元
• 若响应不含 final_unit_deduction，任务不计费并标记为结算失败。
• 仅保留两类积分 SKU：kling-video-points（视频）与 kling-image-points（图像）。

• 可灵 API 开放平台
• 可灵 AI官网

• 认证：Authorization: Bearer <Token>
• 路由：统一使用 /kling 前缀

说明：kling-v1 / kling-v1-5 / kling-v2-1 可在视频与图像接口中复用，实际计费以任务类型为准。

# 文生视频（详细参数见官网）
curl -X POST "https://models.kapon.cloud/kling/v1/videos/text2video" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "夕阳下的海滩，海浪轻轻拍打沙滩",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

# 查询任务
curl "https://models.kapon.cloud/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"