# GhostCut

**Repository Path**: JollyToday/GhostCut

## Basic Information

- **Project Name**: GhostCut
- **Description**: 鬼手剪辑 API 与 Agent Skill 入口。完整文档见 JollyToday/GhostCut-ai。官网 cn.jollytoday.com。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://cn.jollytoday.com/api/
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 5
- **Created**: 2023-03-31
- **Last Updated**: 2026-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 视频文字翻译, 字幕翻译, 视频去重, 视频翻译, 视频去字幕

## README

# 鬼手剪辑：视频去字幕、翻译、配音与 Agent Skill

鬼手剪辑（GhostCut）做 AI 视频本地化：硬字幕去除、OCR/ASR 字幕生成、短剧翻译、AI 配音、音色克隆、图片翻译。面向短剧出海、电商素材和批量译制。

国内官网：[cn.jollytoday.com](https://cn.jollytoday.com/)  
工具：[去字幕](https://cn.jollytoday.com/subtitle-removal/) · [视频翻译](https://cn.jollytoday.com/video-translator/) · [配音](https://cn.jollytoday.com/voice-cloning-and-dubbing/) · [API](https://cn.jollytoday.com/api/)  
凭证：[用户中心](https://cn.jollytoday.com/center/)

本仓库开源的是 **API 示例、Agent Skill 入口，以及技术 / Insights 摘要**。在线能力仍通过官网和 `api.zhaoli.com` 调用。完整 Skill 与插件在 [JollyToday/GhostCut-ai](https://gitee.com/JollyToday/GhostCut-ai)。

[中文](./README.md) · [English](./README_en.md)

## 技术原理（摘要）

流程一般是：提取字幕 → 翻译 → 去画面字 → 配音 → 导出。细节见 [docs/technology.md](./docs/technology.md)，全文在[技术中心](https://cn.jollytoday.com/technology/)。

- **去硬字幕 / 去水印**：OCR 定位 + 时序掩码 + 视频修复（inpainting）。[技术页](https://cn.jollytoday.com/technology/video-subtitle-removal-ocr-inpainting/)
- **字幕从哪来**：有声走 ASR，烧进画面的字走 OCR，统一成可编辑 SRT。[技术页](https://cn.jollytoday.com/technology/ai-subtitle-generation-video-ocr-asr/)
- **短剧翻译**：整剧角色和术语约束，避免串戏、专名飘。[技术页](https://cn.jollytoday.com/technology/short-drama-subtitle-translation-series-context/)
- **模型怎么选**：200 部 × 15 语种实测，结论有日期，不是永久排名。[实测页](https://cn.jollytoday.com/technology/best-short-drama-translation-model-2026/)
- **AI 配音**：角色音色、时长和声画一起对齐，不只换人声。[技术页](https://cn.jollytoday.com/technology/ai-dubbing-audiovisual-reconstruction/)

## Insights 摘要

短剧定义、选市场、版权、译配和发行的一句话索引在 [docs/insights.md](./docs/insights.md)。完整文章：[Insights](https://cn.jollytoday.com/insights/) · [知识图谱](https://cn.jollytoday.com/insights/knowledge-graph/)

先看这三篇：

- [只有硬字幕、没有净版怎么办](https://cn.jollytoday.com/insights/comparisons/ghostcut-subtitle-removal-alternatives/)
- [短剧出海先做哪个国家](https://cn.jollytoday.com/insights/articles/choose-first-overseas-market/)
- [大模型翻译和机翻有什么区别](https://cn.jollytoday.com/insights/comparisons/llm-video-translation-vs-machine-translation/)

## 给 Agent 安装 Skill

需要 Node.js 18+。

```bash
npx skills add zhaoli-ai/GhostCut-ai --skill ghostcut-api-guide
```

国内网络不稳时，把下面这段发给 Cursor / Claude / Codex：

```text
请阅读 https://gitee.com/JollyToday/GhostCut-ai/blob/main/skills.md
并按说明为我安装 GhostCut Skill（ghostcut-api-guide）。
```

安装后可以这样说：

```text
Use $ghostcut-api-guide 帮我用演示视频跑一个视频去文字任务。
```

## 5 分钟调用 API

1. 登录 [用户中心](https://cn.jollytoday.com/center/) 拿到凭证。
2. 设置环境变量（不要把密钥提交到仓库）：

```bash
export GHOSTCUT_APP_KEY="your_app_key"
export GHOSTCUT_APP_SECRET="your_app_secret"
```

3. 签名规则：

```text
AppSign = md5(md5(请求体JSON) + AppSecret)
```

请求体必须和签名用的 JSON 字符串完全一致。本仓库 `sign.py` / `call.py` 是最小示例。

4. 创建视频去文字任务（`POST https://api.zhaoli.com/v-w-c/gateway/ve/work/free`）：

```bash
python3 call.py
```

创建成功只表示任务已提交。从 `body.dataList[0].id` 取作品 ID，再查 `/v-w-c/gateway/ve/work/status`。`processStatus == 1` 时读取 `videoUrl`。

演示视频：`https://gc100.cdn.izhaoli.cn/demo/1691660164246.mp4`

## API 能做什么

| 需求 | 接口 / 文档 |
| --- | --- |
| 去硬字幕、去画面字 | `/work/free`，见 [字幕去除](https://cn.jollytoday.com/subtitle-removal/) |
| 视频翻译与配音 | `/work/free`，见 [视频翻译](https://cn.jollytoday.com/video-translator/) |
| OCR / ASR 出字幕 | `/work/free` |
| 图片擦除、图片翻译 | `/image/translate`，见 [图片翻译](https://cn.jollytoday.com/image-translator/) |
| 短剧 / 剧集批量 | 译制出海模块，见 Skill 内 `51-series-overview` |
| 查任务、查点卡 | `/work/status`、`/point/query` |

完整参数、签名、回调和示例在 GhostCut-ai：

- [API 总览](https://gitee.com/JollyToday/GhostCut-ai/blob/main/skills/ghostcut-api-guide/references/api-guide/00-api-overview.md)
- [5 分钟上手](https://gitee.com/JollyToday/GhostCut-ai/blob/main/skills/ghostcut-api-guide/references/api-guide/01-quickstart.md)
- [鉴权签名](https://gitee.com/JollyToday/GhostCut-ai/blob/main/skills/ghostcut-api-guide/references/api-guide/02-auth-and-sign.md)
- [文档索引](https://gitee.com/JollyToday/GhostCut-ai/blob/main/skills/ghostcut-api-guide/references/api-guide/llms.txt)

## 接到清言、扣子、Dify

不要用本仓库的旧飞书文档当现行说明。导入文件在 GhostCut-ai 的 `plugins/`：

| 平台 | 文件 |
| --- | --- |
| 智谱清言 | [zhipu-qingyan.md](https://gitee.com/JollyToday/GhostCut-ai/blob/main/plugins/zhipu-qingyan.md) |
| 扣子 | [openapi.yaml](https://gitee.com/JollyToday/GhostCut-ai/blob/main/plugins/openapi.yaml) + [coze.md](https://gitee.com/JollyToday/GhostCut-ai/blob/main/plugins/coze.md) |
| Dify / 百炼 | 同一份 OpenAPI，见 [dify.md](https://gitee.com/JollyToday/GhostCut-ai/blob/main/plugins/dify.md) |

## 网站试用

不写代码可以直接用网站：[鬼手剪辑](https://cn.jollytoday.com/) · [价格](https://cn.jollytoday.com/vip/) · [关于我们](https://cn.jollytoday.com/about/)

## 联系

- 微信：360254，备注 gitee
- 邮箱：niumo@izhaoli.com