Kling AI · 概览

• 接口兼容性：API 2.0 使用 /kling/text-to-video/kling-3.0、/kling/image-to-video/kling-3.0 与 /kling/tasks；旧 /kling/v1/** 接口继续兼容。
• 字段与示例：详细字段、取值范围、约束条件以官方文档为准。
• 任务 ID 契约：创建响应中 task_id 为上游原始任务 ID，platform_id 为 Xuwu 平台统一追踪 ID（video_<ULID> 或 image_<ULID>）。查询接口同时接受上游 task_id、平台 platform_id 和 external_task_id。
• 主要能力：
  • 文生视频（text2video）
  • 图生视频（image2video）
  • Omni 视频（omni-video）
  • 动作控制（motion-control）
  • 多图参考生视频（multi-image2video）
  • 视频特效（video-effects）
  • 视频延长（video-extend）
  • 对口型（advanced-lip-sync）
  • 图像生成（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 2.0 的 Kling 3.0 视频成功后按 duration × 官方 Units/秒 结算；billing[] 仅作为上游消费证据。

• 可灵 API 开放平台
• API 鉴权
• 视频价格
• 图片价格
• 可灵 AI 官网

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

说明：kling-v1 / kling-v1-5 / kling-v2-1 / kling-v3 可在视频与图像能力中复用，实际计费以任务类型为准。kling-v3-omni 仅通过 Omni 视频 /videos/omni-video 与 Omni 图像 /images/omni-image 入口展示。历史输入 kling-v2-5 会归一为 kling-v2-5-turbo，不作为对外 canonical 模型展示。

# 文生视频（详细参数见官网）
curl -X POST "https://xuwuai.com/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://xuwuai.com/kling/v1/videos/text2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"