# kling-official

Скилл kling-official для OpenMontage: подсказывает агенту, как вызывать официальный API Kling — видео, картинки, озвучку, аватары и липсинк.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 78316 у репозитория
- Автор: calesthio
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/kling-official/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/kling-official

## Что делает

Скилл описывает работу с официальным API Kling для инструментов OpenMontage: `kling_official_video`, `kling_official_image`, `kling_tts`, `kling_avatar`, `kling_lip_sync`. Авторизация — `KLING_API_KEY` в заголовке Bearer, базовый адрес по умолчанию `https://api-singapore.klingai.com`, его можно переопределить через `KLING_API_BASE_URL`. Без `KLING_API_KEY` не запустится ни один из этих инструментов, поэтому ключ нужен до первого вызова.

Внутри три семейства протоколов: classic, turbo и omni. У них разные поля задачи и разные слова статусов, и скилл запрещает писать парсер, который угадывает между ними. Turbo для image-to-video требует ссылку на первый кадр; локальный файл через fal.ai не подкладывается. Для `kling_tts` нужен явный `voice_id`, язык — `zh` или `en`.

Липсинк идёт в два шага: сначала поиск лиц по видео, потом сборка с выбранным `face_id`. Если лиц несколько и выбор не задан, скилл останавливается и просит подтвердить. Провайдер `kling_official` не подменяет путь `kling_video` из fal.ai с его `FAL_KEY`: при недоступности выбранного варианта агент сообщает о блокере и спрашивает.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill kling-official -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/kling-official/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/kling-official/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill kling-official -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/kling-official/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill kling-official -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/kling-official/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/OpenMontage .agents/skills/kling-official
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/kling-official/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill kling-official -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/kling-official
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/kling-official/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/kling-official/SKILL.md

## Когда брать
- Сгенерировать видео напрямую через аккаунт Kling
- Озвучить реплики голосом из аккаунта и сохранить файлы локально
- Сделать липсинк по готовому ролику с выбором лица
- Собрать говорящий аватар из фото и аудио
- Сгенерировать картинку с привязкой референсов по плейсхолдерам `<<<image_1>>>`

## Примеры запросов агенту
- Сгенерируй видео через `provider="kling_official"`, `api_family="classic"`, первый кадр возьми из `frame.png`
- Озвучь текст из `script.txt` через `kling_tts`, `voice_language="en"`, `voice_id` я пришлю
- Сделай липсинк для `clip.mp4`: сначала найди лица и покажи список, выбор подтвержу сам

## Похожие
- [fal-kling-o3](https://affpapa.org/nevibecode/skills/fal-kling-o3.md) — скилл · 2900 установок
- [kling-3-0](https://affpapa.org/nevibecode/skills/kling-3-0.md) — скилл · 424000 установок
- [kling-3-prompting](https://affpapa.org/nevibecode/skills/kling-3-prompting.md) — скилл · 635 установок
- [kling-video](https://affpapa.org/nevibecode/skills/kling-video.md) — скилл · 240 установок
- [Kling](https://affpapa.org/nevibecode/mcp/kling.md) — MCP-сервер · ★ 14 у репозитория
- [kling-advanced-lip-sync](https://affpapa.org/nevibecode/skills/kling-advanced-lip-sync.md) — скилл · 131 установка

Из того же набора: [calesthio/openmontage](https://affpapa.org/nevibecode/by/calesthio/openmontage.md) — 101 карточка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
