自定义 API

自定义 API 让 kk 使用你自己申请的服务商密钥。kk 本身免费,服务商的费用直接付给服务商,音频和文本只在你的电脑与所选服务商之间传输,不经过 kk 的服务器。

需要配置的角色

kk 把功能拆成几个角色,每个角色可以分别选择服务商和模型。

角色 是否必填 作用
语音识别 必填 把课堂声音实时转成英文原文
翻译 必填 把原文译成你选择的语言。可以用识别服务自带的流式翻译(如果该服务提供),也可以用大模型
阶段分析与标题 可选 生成阶段重点、课次标题与分类建议,默认也用来写课后笔记。不配置时这些功能不可用
课堂问答 可选 回答你对本课内容的提问,可以添加多个模型并在输入框里切换。默认复用阶段分析的模型

只配置识别和翻译就可以开始翻译;阶段重点、问答和笔记按需补充。

配置步骤

  1. 申请密钥。在服务商的控制台创建 API 密钥。设置里每个服务商下方有对应的获取说明。
  2. 填入设置。打开「设置」,在「语音识别」中选择服务商并填入密钥,点击「保存密钥」;再到「翻译」和「阶段分析与标题」里选择服务商、模型并填入密钥。同一个服务商只需要保存一次密钥。
  3. 测试连接。每个角色都有「测试连接」按钮:成功时显示绿点和耗时,失败时显示红点和原因。大模型的耗时是首字延迟,识别服务的耗时是建立连接的用时。

密钥只保存在 Windows 凭据管理器里,不写入项目文件夹、不上传,也不会被同步到云端。换服务商不会把旧服务商的密钥发给新服务商。

可选的服务商

语音识别

AssemblyAI、Deepgram、Speechmatics、Gladia、ElevenLabs、OpenAI、Groq、腾讯云、讯飞、阿里云百炼、火山引擎。不同服务对语种、术语提示和翻译的支持不同,设置里会在选中后提示。

翻译、阶段分析与问答

DeepSeek、Claude、Google Gemini、OpenAI、OpenRouter、硅基流动、火山方舟、Kimi、通义千问、智谱,以及本机运行的 Ollama。

列表以软件内为准,会随版本增加。如果你的服务商提供 OpenAI 兼容接口,可以在服务商下拉菜单底部选择「添加服务商…」,填写名称和接口地址(需要以 https:// 开头)后使用。

内置服务商只提供名称和接口地址,不替你预填模型:从服务商的模型列表里选择,或自己填写模型名。

语言与术语

  • 「翻译语言」决定字幕译文以及阶段重点、标题、笔记和问答使用的语言,可选中文、English、日本語、한국어。
  • 「上课语言」告诉识别服务老师主要说什么语言。部分识别服务只按英文识别,此时设置里会给出提示。
  • 识别服务支持术语提示时,kk 会把你手动添加或确认过的专业词发给它,以减少听错,见术语表。

费用与数据

  • 费用由服务商按其价格计算,kk 不收取任何费用,也无法代为查看你的服务商账单。
  • 音频从你的电脑直接发送到所选的语音识别服务商,文本发送到所选的大模型服务商,请参阅它们各自的隐私政策。
  • 使用自定义 API 时,kk 不会向官方服务上传你的课程内容,详见数据与遥测。

功能差异

自定义 API 可以使用实时字幕、悬浮窗和字幕条、阶段重点、知识库、笔记、术语表和导入音视频。云同步、网页版和课件跟随讲课目前只提供给 kk Pass 用户。

最后更新:2026 年 11 月 15 日