PotPlayer_ChatGPT_Translate

看视频实时翻译字幕，支持任意 OpenAI 兼容模型

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 73 🐛 待处理 3 👀 关注 3

GitHub ↗

GitHub 星标 ★ 1074

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源插件，GPL-3.0许可，完全免费，需自行部署并配置API密钥，调用模型可能产生第三方费用。

项目预览

PotPlayer_ChatGPT_Translate 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类对话助手

开发团队Felix3322

GitHubhttps://github.com/Felix3322/PotPlayer_ChatGPT_Translate

定价模式🏷️完全免费

价格说明开源插件，GPL-3.0许可，完全免费，需自行部署并配置API密钥，调用模型可能产生第三方费用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议GPL-3.0

主要语言AngelScript

技术栈/模型ai-translator,anglescript,api,chatgpt,chatgpt-api,language,language-model,languages,llm,openai,openai-api,player-video,plugin,plugins,potplayer,potplayer-extension,script,scripts,translate,translation

GitHub 星标★ 1074

上线时间2024-11-20 00:00:00

代码更新2026-11-01

仓库体积303.1 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数4

项目介绍

PotPlayer_ChatGPT_Translate 是一款专为 PotPlayer 播放器设计的实时字幕翻译插件。它通过集成 OpenAI API 或任何兼容该接口的模型（如 Ollama 本地模型），在视频播放过程中自动抓取并翻译字幕，帮助用户跨越语言障碍，提升观影体验。核心能力包括：支持自定义 API 地址和模型参数，兼容多种语言对，提供实时翻译结果，并可通过快捷键或菜单快速切换翻译开关。该插件采用 C++ 编写，基于 AngleScript 实现，轻量高效，安装简单，适合外语影视爱好者、语言学习者及需要处理多语言视频内容的用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1074

技术标签

api chatgpt chatgpt-api language language-model

使用教程

难度：入门约 10 分钟部署方式：本地安装 8 步

环境要求

Windows 系统，并已安装 PotPlayer 播放器
能访问 GitHub Releases 下载最新安装包
一个 OpenAI 兼容的 API 地址与密钥（本地服务可不需要密钥）
如使用本地模型，需提供 OpenAI 兼容接口，例如 http://127.0.0.1:11434/v1/chat/completions

安装与启动步骤

1下载最新安装包

打开项目的 Release 页面，下载最新版的安装程序 installer.exe，普通用户推荐用全自动安装方式。
2运行安装程序

双击运行 installer.exe；若弹出 Windows 管理员权限提示，请点击同意以允许写入 PotPlayer 插件目录。
3确认插件目录

安装器会自动检测 PotPlayer 路径，目标目录通常为 ...\PotPlayer\Extension\Subtitle\Translate；自定义安装位置时手动选择该 Translate 文件夹。
4选择插件版本

带上下文版本翻译质量更好，但延迟和 token 消耗略高；不带上下文版本更快更省，但缺少上下文感知。
5配置模型与接口

在模型栏填写模型名；使用自定义接口时按「模型名|接口地址」填写，模型名可替换为服务商支持的任何兼容模型。
```
gpt-4.1-nano|https://api.openai.com/v1/chat/completions
```
6填写 API Key

接口需要密钥时填入密钥；若接口不需要密钥则留空并点击 Verify 测试，测试成功后安装器会自动注入 nullkey。
7点击 Install 安装

安装器会把插件文件复制到 PotPlayer 的字幕翻译扩展目录，并可注册卸载项，便于以后干净卸载。
8在 PotPlayer 中启用

打开 PotPlayer，按 F5 打开选项，进入 Extensions > Subtitle translation，选择 ChatGPT Translate，设置源语言与目标语言，并确认模型、API URL、API Key。

关键配置

配置项	必填	说明	示例
`Model Name（模型名）`	是	填写模型名；用「模型名\|接口地址」可自定义 API 端点，本地服务再加 \|nullkey。	`gpt-4.1-nano\|https://api.openai.com/v1/chat/completions`
`API Key`	否	接口需要认证时填写；无需密钥则留空并点 Verify，安装器会自动注入 nullkey。	`sk-xxxxxxxx`

如何确认成功

按 F5 打开选项，在 Extensions > Subtitle translation 中能看到并选中 ChatGPT Translate，播放带字幕视频时能实时返回译文即成功。

常见问题

Q：用 Ollama 等本地模型怎么填？

A：按「模型名|接口地址|nullkey」填写，例如 qwen2.5:7b|http://127.0.0.1:11434/v1/chat/completions|nullkey；本地无需密钥时用 nullkey。

Q：为什么安装器里设置的参数没生效？

A：安装器默认值只写入一次。之后如在 PotPlayer 插件面板中改过设置，PotPlayer 自身的设置会覆盖安装器默认值。

Q：带上下文和不带上下文版本怎么选？

A：影视剧、动漫、纪录片等对话密集内容用带上下文版本；更看重速度和低 token 消耗时用不带上下文版本。

Q：翻译输出异常长怎么办？

A：可启用 checkhallucination=1；若 API 服务商有严格速率限制，可增加请求延迟。

注意事项

手动安装（面向高级用户）：解压 ZIP 后把 ChatGPTSubtitleTranslate.as 和 ChatGPTSubtitleTranslate.ico 复制到 C:\Program Files\DAUM\PotPlayer\Extension\Subtitle\Translate（按实际
在带上下文与不带上下文的脚本之间切换时，需要成组替换相关的 .as 文件。
旧脚本副本可能共用 FormatFailureTranslation 等辅助名，会因加载顺序导致冲突，请使用当前版本文件。
想进一步提升效果可换用更强模型处理俚语、文化梗和术语，或换更小更便宜的模型以节省成本。