Skip to content

feat(kling): migrate to Kling API 2.0 (path-based endpoints, API Key auth) - #59

Open
Yuyyxz wants to merge 1 commit into
alibaba:mainfrom
Yuyyxz:feat/kling-api-v2
Open

feat(kling): migrate to Kling API 2.0 (path-based endpoints, API Key auth)#59
Yuyyxz wants to merge 1 commit into
alibaba:mainfrom
Yuyyxz:feat/kling-api-v2

Conversation

@Yuyyxz

@Yuyyxz Yuyyxz commented Aug 11, 2026

Copy link
Copy Markdown

Summary

Kling 开放平台已升级到 API 2.0 标准: 模型版本信息位于路径中, 鉴权统一为 API Key(Bearer), 请求体改为 contents/settings/options 三层结构。当前 src/models/kling.py 仍使用旧版设计(AK/SK JWT 签名 + model_name 参数 + 平铺请求体), 无法接入新版接口。

本 PR 将 Kling adapter 迁移到 API 2.0, 使 LumenX 可以直连新版可灵接口(开放平台单 API Key 即可, 无需 AK/SK 对)。

Changes

文件 改动
src/models/kling.py 认证: AK/SK JWT → Bearer API Key (KLING_API_KEY); 提交: POST /image-to-video/{model_id} (模型在路径); 请求体: contents[]/settings{}/options{} 三层; 轮询: GET /tasks?task_ids= (批量, status 枚举 succeeded); 参数翻译: std/pro → 720p/1080p, sound → audio
src/utils/endpoints.py KLING base URL 去掉 /v1 前缀 (新版 API 根路径)
config/model_catalog/families/kling.yaml vendor 凭证源改为 KLING_API_KEY

Verification

用真实 API Key 提交图生视频请求, 返回:

{"code": 1102, "message": "Account balance not enough"}
  • ✅ 鉴权正确 (Bearer key 被接受, 非 401)
  • ✅ 路径正确 (POST /image-to-video/kling-3.0 被路由, 非 404)
  • ✅ 请求格式正确 (三层 body 被解析, 非 400)
  • ✅ 走到业务层错误 (余额不足)

说明请求契约已被新版 API 完整接受, 只差账户余额即可真实出片。

Notes

  • 保持向后兼容: 调用方仍可传 model/mode/sound 等旧参数名, adapter 内部翻译
  • 模型 ID 默认 kling-3.0 (路径式), 旧 kling-v3 映射保留在 factory 路由中

…auth)

- Auth: replace AK/SK JWT signing with Bearer API Key (KLING_API_KEY)
- Submit: POST /image-to-video/{model_id} (model in path, API 2.0 standard)
- Body: contents[]/settings{}/options{} three-layer structure
- Poll: GET /tasks?task_ids= (batch, status enum: succeeded)
- Params: translate legacy std/pro -> 720p/1080p, sound -> audio
- Catalog: vendor credential source now KLING_API_KEY

Verified against live API: request accepted, reaches business-layer
error (code 1102 balance) instead of 404/401.
@CLAassistant

CLAassistant commented Aug 11, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@Yuyyxz

Yuyyxz commented Aug 18, 2026

Copy link
Copy Markdown
Author

@Mike4Ellis 您好,感谢查看这个 PR。
目前有一个工作流(workflow)正在等待批准才能运行。如果方便的话,麻烦帮忙审批一下,让自动化测试跑起来。
代码已经确认无冲突且 CLA 已签署。如果测试通过或有任何需要修改的地方,请随时告诉我,我会尽快处理。谢谢!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants