PotPlayer_ChatGPT_Translate

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

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

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1044

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队Felix3322

所属国家

官网地址

GitHubhttps://github.com/Felix3322/PotPlayer_ChatGPT_Translate

定价模式free

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

访问状态

是否开源是

开源协议GPL-3.0

主要语言C++

技术栈/模型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 星标★ 1044

30天Star增速

HF 下载量

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

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 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 路径，目标目录通常为 ...PotPlayerExtensionSubtitleTranslate；自定义安装位置时手动选择该 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 FilesDAUMPotPlayerExtensionSubtitleTranslate（按实际
在带上下文与不带上下文的脚本之间切换时，需要成组替换相关的 .as 文件。
旧脚本副本可能共用 FormatFailureTranslation 等辅助名，会因加载顺序导致冲突，请使用当前版本文件。
想进一步提升效果可换用更强模型处理俚语、文化梗和术语，或换更小更便宜的模型以节省成本。

核心亮点

支持 Ollama 等本地模型，数据隐私更安全且无需联网
实时翻译延迟低，观看体验流畅
可自定义 API 端点和模型参数，灵活适配不同服务

不足之处

仅支持 PotPlayer，无法用于其他播放器
文档/社区待观察

适用场景

观看无字幕或外语字幕的电影、剧集时实时翻译
学习外语时对照原文与翻译，提升听力理解
处理本地视频文件，利用本地模型离线翻译字幕

替代项目

VideoSubFinder、SubtitleEdit、VLC Translate

项目介绍

PotPlayer_ChatGPT_Translate 是行业应用领域的开源项目，由 Felix3322 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,044）位列前 30%，在行业应用分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,022 增加到 1,044，净增 22。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。开源插件，GPL-3.0许可，完全免费，需自行部署并配置API密钥，调用模型可能产生第三方费用。

它主要面向的使用场景是：观看无字幕或外语字幕的电影、剧集时实时翻译。同类可对比的替代方案包括 VideoSubFinder、SubtitleEdit、VLC Translate。

上一篇：pybibx

下一篇：Agent4Edu