选择协议
新接入视频应用使用 API 2.0。已有/kling/v1/** 调用可继续使用对应 Legacy 页面。图片当前官方接口仍是 /v1/images/**。
客户端访问平台均使用
Authorization: Bearer <Kapon Token>。API 2.0 的路径模型和 Legacy 的 model_name 不作为别名互相替换。
支持模型
同名
kling-v3 和 kling-v3-omni 在旧协议中可用于视频或图片，实际能力由调用路径决定。
任务与计费
- 创建任务后，用相同协议的查询接口获得状态和完整结果。
- 仅查询当前用户拥有的任务。结果中的图片、组图、水印URL均应及时保存；上游链接存在有效期。
- 创建前先预留钱包与令牌额度，成功终态确认一次消费并释放差额，确定失败后释放预留。
- API 2.0 按模型、声音、参考视频和时长分档，详见新版计费说明。
- Legacy 按上游
final_unit_deduction与对应客户积分单价结算；无积分时不猜测扣费。 - 旧图片当前可预留的模型为普通生图
kling-v3/kling-v2-1、Omnikling-image-o1/kling-v3-omni、多图参考kling-v2-1；请显式指定模型。Omni 组图可用固定数量 2～9，省略数量按 4；auto暂不可用。 - 其他旧图片组合及主体创建尚缺可靠费用上界，在有效渠道下返回 HTTP 400，错误消息明确说明创建暂不可用，不会提交付费上游。已有任务仍可查询和处理。
- 客户实际扣款以平台消耗记录为准，上游返回的消费字段保留供对账。