Appearance
Kling 接口一览与测试脚本
Base URL：https://agentpivot.ai/kling/v1（本地：export BASE_URL="http://localhost:8097"）
鉴权：x-api-key 或 Authorization: Bearer <token>，脚本中需 export API_KEY="<key>" 或 export AUTH_HEADER="Bearer <token>"。
- Url：https://agentpivot.ai/
- api-key: 平台创建
一、旧版 Kling 接口（直接透传上游，返回 taskId/code/message/requestId）
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /omni-video | Kling Omni 生视频 | ./test-kling-omni-video.sh |
| POST | /text2video | Kling 文生视频 | ./test-kling-text2video.sh |
| POST | /image2video | Kling 图生视频 | ./test-kling-image2video.sh |
二、官方 Kling 视频类（创建/列表/查询单个）
文生视频
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/text2video | 创建文生视频任务 | ./test-kling-official-text2video.sh |
| GET | /videos/text2video | 查询任务列表 | 同上 |
| GET | /videos/text2video/:id | 查询单个任务 | 同上 |
Omni 生视频
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/omni-video | 创建 Omni 生视频任务 | ./test-kling-official-omni-video.sh |
| GET | /videos/omni-video | 查询任务列表 | 同上 |
| GET | /videos/omni-video/:id | 查询单个任务 | 同上 |
图生视频
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/image2video | 创建图生视频任务 | ./test-kling-official-image2video.sh |
| GET | /videos/image2video | 查询任务列表 | 同上 |
| GET | /videos/image2video/:id | 查询单个任务 | 同上 |
多图参考生视频
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/multi-image2video | 创建多图参考生视频任务 | ./test-kling-official-multi-image2video.sh |
| GET | /videos/multi-image2video | 查询任务列表 | 同上 |
| GET | /videos/multi-image2video/:id | 查询单个任务 | 同上 |
动作控制
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/motion-control | 创建动作控制任务 | ./test-kling-official-motion-control.sh |
| GET | /videos/motion-control | 查询任务列表 | 同上 |
| GET | /videos/motion-control/:id | 查询单个任务 | 同上 |
视频延长
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/extend | 创建视频延长任务 | ./test-kling-official-extend.sh |
| GET | /videos/extend | 查询任务列表 | 同上 |
| GET | /videos/extend/:id | 查询单个任务 | 同上 |
视频生音效
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/video-to-audio | 创建视频生音效任务 | ./test-kling-official-video-to-audio.sh |
| GET | /videos/video-to-audio | 查询任务列表 | 同上 |
| GET | /videos/video-to-audio/:id | 查询单个任务 | 同上 |
数字人 Avatar
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/avatar/image2video | 创建数字人 image2video 任务 | ./test-kling-official-avatar.sh |
| GET | /videos/avatar/image2video | 查询任务列表 | 同上 |
| GET | /videos/avatar/image2video/:id | 查询单个任务 | 同上 |
对口型 Lip Sync
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/lip-sync/face-detect | 对口型人脸识别 | ./test-kling-official-lip-sync.sh |
| POST | /videos/lip-sync | 创建对口型任务 | 同上 |
| GET | /videos/lip-sync | 查询任务列表 | 同上 |
| GET | /videos/lip-sync/:id | 查询单个任务 | 同上 |
图像识别
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /videos/image-recognize | 图像识别（主体/人脸/服装等） | ./test-kling-official-image-recognize.sh |
三、官方 Kling 音频类
文生音效 Text to Audio
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /audio/text-to-audio | 创建文生音效任务 | ./test-kling-official-text-to-audio.sh |
| GET | /audio/text-to-audio | 查询任务列表 | 同上 |
| GET | /audio/text-to-audio/:id | 查询单个任务 | 同上 |
语音合成 TTS
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /audio/tts | 创建语音合成任务（同步返回） | ./test-kling-official-tts.sh |
自定义音色（音色克隆）
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /general/custom-voices | 创建自定义音色 | ./test-kling-official-custom-voices.sh |
| GET | /general/custom-voices/:id | 查询自定义音色（单个） | 同上 |
| GET | /general/custom-voices | 查询自定义音色（列表） | 同上 |
| GET | /general/presets-voices | 查询官方音色（列表） | 同上 |
四、官方 Kling 主体管理 Element
| 方法 | 路径 | 说明 | 测试脚本 |
|---|---|---|---|
| POST | /general/advanced-custom-elements | 创建自定义主体 | ./test-kling-official-elements.sh |
| GET | /general/advanced-custom-elements/:id | 查询自定义主体（单个） | 同上 |
| GET | /general/advanced-custom-elements | 查询自定义主体（列表） | 同上 |
| GET | /general/advanced-presets-elements | 查询官方主体（列表） | 同上 |
| POST | /general/delete-elements | 删除自定义主体 | 同上（脚本内注释示例） |
测试脚本汇总
| 脚本 | 覆盖接口 |
|---|---|
test-kling-omni-video.sh | POST /omni-video（旧版） |
test-kling-text2video.sh | POST /text2video（旧版） |
test-kling-image2video.sh | POST /image2video（旧版） |
test-kling-official-text2video.sh | 文生视频 创建/列表/单个 |
test-kling-official-omni-video.sh | Omni 生视频 创建/列表/单个 |
test-kling-official-image2video.sh | 图生视频 创建/列表/单个 |
test-kling-official-multi-image2video.sh | 多图参考生视频 创建/列表/单个 |
test-kling-official-motion-control.sh | 动作控制 创建/列表/单个 |
test-kling-official-extend.sh | 视频延长 创建/列表/单个（需 EXTEND_TASK_ID） |
test-kling-official-video-to-audio.sh | 视频生音效 创建/列表/单个 |
test-kling-official-avatar.sh | 数字人 image2video 创建/列表/单个 |
test-kling-official-lip-sync.sh | 对口型 人脸识别/创建/列表/单个 |
test-kling-official-text-to-audio.sh | 文生音效 创建/列表/单个 |
test-kling-official-tts.sh | 语音合成 TTS 创建 |
test-kling-official-custom-voices.sh | 自定义音色 创建/单个/列表/官方音色列表 |
test-kling-official-image-recognize.sh | 图像识别 |
test-kling-official-elements.sh | 主体管理 创建/列表/单个/官方列表（删除示例已注释） |
运行前在 scripts 目录下执行：
bash
export API_KEY="<your-api-key>"
./test-kling-official-tts.sh