KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #cli #react #mcp

keling-video-workbench

★ 1 Open GitHub ↗

Open-source local workbench for Kling AI video generation.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Keling Video Workbench（可灵视频工作台）

一个开源的本地视频生成工作台，用来通过可灵（Kling AI）API 提交文生视频、图生视频任务，管理参考图、任务历史和生成结果。

项目默认以测试模式运行，不需要 API Key 也可以先体验流程。关闭测试模式并填入自己的可灵 API Key 后，就可以请求真实 API。

> 本项目不是可灵官方项目，只是一个面向个人和小团队的本地工具。

## 功能

- 本地浏览器工作台和 Electron 桌面 App。
- 支持可灵 API Key Bearer 鉴权，也保留 AccessKey + SecretKey JWT 兼容模式。
- 支持文生视频、参考图上传和图生视频输入。
- 支持 5、10、15、30、45、60、90、120 秒时长选项。
- 本地保存 API 配置、任务历史、参考图和结果链接。
- API Key、任务记录和上传文件只保存在本机，不会提交到 Git 仓库。

## 快速开始

需要 Node.js 18 或更高版本。

```bash
npm install
npm run dev
```

默认访问地址：

```text
http://127.0.0.1:4173
```

## 桌面 App

开发方式启动桌面端：

```bash
npm run desktop
```

打包 macOS `.app`：

```bash
npm run desktop:package
```

打包产物会输出到：

```text
dist/可灵视频工作台-darwin-<arch>/可灵视频工作台.app
```

`dist/` 是本机打包输出，默认不会提交到仓库。

## 配置真实 API

可以在 App 的“本地 API 配置”里保存 API Base URL、模型名称、鉴权方式和 API Key。配置会写入本机 `data/settings.json`。

推荐配置：

```text
API Base URL: https://api-singapore.klingai.com
模型名称: kling-3.0-turbo
鉴权方式: API Key（所有模型）
```

如果你的 Key 形如 `api-key-kling-...`，请选择 `API Key（所有模型）`，只填 `API Key / AccessKey` 输入框，`Secret Key` 留空。

也可以复制 `.env.example` 为 `.env`：

```bash
cp .env.example .env
```

使用真实 API 时，将 App 里的“测试模式”关闭，或在 `.env` 中设置：

```text
KLING_USE_MOCK=false
```

只有拿到 AccessKey + SecretKey 两段凭证时，才将 `KLING_AUTH_MODE` 改为 `jwt` 并填写 `KLING_API_SECRET`。

## 目录结构

```text
desktop/  Electron 桌面壳
server/   本地 Node 服务、API 路由、可灵适配层、任务/设置/文件存储
web/      本地工作台界面、状态管理、API 请求模块
docs/     架构和交付说明
data/     开发模式下的本地运行数据，真实记录不提交
```

## 本地隐私

以下文件和目录会被 `.gitignore` 忽略：

```text
.env
data/settings.json
data/tasks.json
data/assets.json
data/uploads/
data/results/
dist/
```

发布或提交前请不要把自己的 API Key、任务历史、上传图片或生成结果加入版本控制。

## 许可

本项目使用 MIT License 开源，欢迎 fork、改造和自用。

keling-video-workbench

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README