模型 API 与 Key 安全说明

AI 智能纪要是可选功能。本地转写不需要 API Key；关闭 summary_enabled 后仍会生成文字记录。

默认推荐

仓库默认使用 deepseek-v4-pro。它的纪要质量更好，价格高于 Flash 但仍然很低，常见录音纪要的单次调用通常只有几分钱，并非绝对零成本。追求更低成本可在 config.json 里改回 deepseek-v4-flash。

截至 2026-07-20，DeepSeek 官方人民币价格为：deepseek-v4-pro 缓存未命中输入 3 元 / 百万 tokens，输出 6 元 / 百万 tokens（deepseek-v4-flash 为 1 元 / 2 元）。价格和型号可能变化，安装与宣传时以官方价格页为准。

申请步骤

1. 打开 DeepSeek 开放平台。
2. 注册并按平台要求完成必要的账号验证。
3. 在控制台创建 API Key。Key 通常只完整显示一次，立即保存到密码管理器。
4. 如账户没有可用余额，到平台充值页面按实际使用量充值。不要依赖教程里的固定最低金额。
5. 回到项目运行 python scripts/setup.py，在安全输入提示中粘贴 Key。

官方入口：

• 第一次 API 调用
• 模型与价格
• 错误码

模型名称和价格会变化。仓库当前默认使用 deepseek-v4-pro，升级时先核对官方文档。

Key 存在哪里？

向导把 Key 写进项目根目录 .env：

DEEPSEEK_API_KEY=YOUR_API_KEY

.env 已被 .gitignore 排除。不要把真实 Key：

• 写进 config.json；
• 粘贴到聊天窗口或发给他人；
• 放进截图或录屏；
• 提交到 GitHub；
• 发到 Issue 或日志附件。

使用其他模型服务

项目不绑定 DeepSeek。只要服务商兼容 OpenAI Chat Completions 接口，就可以使用自己的 API Key。需要修改三个字段：

• summary_api_base：服务商的 API 基础地址；
• summary_model：模型名称；
• summary_api_key_env：本机环境变量名。

Key 仍然只写进 .env，不要直接写进 config.json。

手工配置示例

不使用向导时，自己创建 .env，再在 config.json 填：

{
  "summary_enabled": true,
  "summary_api_base": "https://api.deepseek.com",
  "summary_model": "deepseek-v4-pro",
  "summary_api_key_env": "DEEPSEEK_API_KEY"
}

使用其他兼容接口时，修改 API 地址、模型名和 Key 环境变量名即可，程序会请求 <summary_api_base>/chat/completions。

常见错误

错误	含义	处理
401 / 403	Key 无效或没有权限	重新创建 Key，检查是否复制完整
402	余额不足	到开放平台检查余额
429	请求过快或受限	稍后重试，避免同时提交大量录音
500 / 503	服务端异常或过载	后台会重试，稍后再看