# kling-skills

**Repository Path**: Darchrow-Mu/kling-skills

## Basic Information

- **Project Name**: kling-skills
- **Description**: 一个claude code skills，可灵AI的API封装，可以生成图片和视频，需要本地环境变量配置密钥。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kling Skills

可灵AI 全量 API 技能包，提供 MCP Server 和 CLI 脚本两种使用方式。

## 功能特性

- 🎬 **视频生成** — Omni视频、文生视频、图生视频、多图生视频
- 🖼️ **图像生成** — Omni图像、文生图、多图参考生图
- 🎵 **音频处理** — TTS语音合成、音效生成、音色克隆
- 🎭 **特效编辑** — 动作控制、对口型、数字人
- 📦 **主体管理** — 主体创建、预设元素管理

## 快速开始

### 环境要求

- Python 3.8+
- 可灵AI 账号及 API 密钥

### 配置环境变量

```bash
export KLINGAI_ACCESS_KEY="your-access-key"
export KLINGAI_SECRET_KEY="your-secret-key"
```

### 方式一：MCP Server（推荐）

MCP Server 提供 52 个工具，可在 Claude Code 等 AI 助手中直接调用。

```bash
# 启动 MCP Server
python3 kling_mcp/server.py
```

在 Claude Code 的 `settings.local.json` 中配置：

```json
{
  "mcpServers": {
    "kling": {
      "command": "python3",
      "args": ["/path/to/kling-skills/kling_mcp/server.py"]
    }
  }
}
```

### 方式二：CLI 脚本

```bash
# Omni 图像生成（推荐）
python3 scripts/omni_image.py --prompt "一只可爱的猫咪" --output result.png

# Omni 视频生成（推荐）
python3 scripts/omni_video.py --prompt "猫咪在草地上奔跑" --output result.mp4

# 文生图
python3 scripts/txt2img.py --prompt "风景画" --output image.png

# 图生视频
python3 scripts/multi_img2video.py --images img1.png,img2.png --output video.mp4

# TTS 语音合成
python3 scripts/tts_batch.py --text "你好世界" --output audio.mp3
```

## API 优先级推荐

### 图像生成

| 优先级 | API | 模型 | 优势 |
|--------|-----|------|------|
| ⭐⭐⭐ | Omni图像 | `kling-v3-omni` | 主体控制、多图融合、1K/2K/4K |
| ⭐⭐ | 文生图 | `kling-v3` | 简单单图生成 |
| ⭐ | 多图参考生图 | `kling-v2-1` | 多图参考场景 |

### 视频生成

| 优先级 | API | 模型 | 优势 |
|--------|-----|------|------|
| ⭐⭐⭐ | Omni视频 | `kling-v3-omni` | 主体控制、多镜头、音画同步 |
| ⭐⭐ | 图生视频 | `kling-v2-6` | 首尾帧+运动笔刷 |
| ⭐⭐ | 文生视频 | `kling-v3` | 纯文本生成视频 |

## 项目结构

```
kling-skills/
├── kling_mcp/          # MCP Server（52个工具）
│   └── server.py       # 服务入口
├── scripts/            # CLI 脚本
│   ├── omni_image.py   # Omni 图像生成
│   ├── omni_video.py   # Omni 视频生成
│   ├── txt2img.py      # 文生图
│   ├── multi_img2img.py    # 多图生图
│   ├── multi_img2video.py  # 多图生视频
│   ├── tts_batch.py    # TTS 批量合成
│   └── tts_chattts.py  # ChatTTS 本地合成
├── core/               # 核心模块
│   ├── auth.py         # JWT 鉴权
│   ├── client.py       # HTTP 客户端
│   ├── poll.py         # 异步轮询
│   ├── utils.py        # 工具函数
│   └── validators.py   # 输入验证
├── references/         # API 文档参考
└── docs/               # 测试报告
```

## MCP 工具列表（52个）

### 视频类
- `video_omni_submit/query` — Omni 视频
- `video_t2v_submit/query` — 文生视频
- `video_i2v_submit/query` — 图生视频
- `video_multi_i2v_submit/query` — 多图生视频
- `video_extension_submit/query` — 视频延长

### 动作/编辑
- `motion_control_submit/query` — 动作控制
- `video_edit_submit/query` — 视频编辑

### 对口型/数字人
- `lip_sync_identify_face` — 人脸识别
- `lip_sync_submit/query` — 对口型
- `avatar_submit/query` — 数字人

### 音频类
- `tts_submit/query` — TTS 合成
- `text_to_audio_submit/query` — 文生音频
- `video_to_audio_submit/query` — 视频生音频
- `custom_voice_submit/query` — 自定义音色

### 图像类
- `image_omni_submit/query` — Omni 图像
- `image_gen_submit/query` — 文生图
- `image_multi_ref_submit/query` — 多图参考
- `image_expansion_submit/query` — 图像扩展
- `ai_multi_shot_submit/query` — AI 多镜头
- `virtual_tryon_submit/query` — 虚拟试穿
- `image_recognize` — 图像识别

### 主体管理
- `element_create_submit/query` — 创建主体
- `element_list` — 主体列表
- `preset_element_list` — 预设主体

### 辅助工具
- `account_info` — 账户信息
- `video_models` — 视频模型列表
- `image_models` — 图像模型列表
- `kling_skills` — 技能列表
- `poll_task` — 轮询任务
- `download_result` — 下载结果

## 获取 API 密钥

1. 访问 [可灵AI 开放平台](https://open.klingai.com/)
2. 注册/登录账号
3. 在控制台创建应用获取 Access Key 和 Secret Key

## 文档

- [API 测试报告](docs/API_TEST_REPORT.md)
- [模型选型指南](references/model-guide.md)
- [完整 API 文档](references/api-docs/)

## License

MIT