API 配置
声墨开箱即用，但如果你想用自己的 AI 服务，可以在这里配置。
什么时候需要配置？
大多数用户不需要配置任何东西。声墨默认使用云端服务，联网即可使用。
以下情况你可能需要配置：
- 想用自己的 AI 服务（比如 OpenAI、DeepSeek）
- 公司有私有的 AI 网关
- 想控制 AI 的调用成本
配置前准备
- 确认服务商账号可用且有余额/额度
- 准备好 API Key（注意不要泄露）
- 若使用自定义地址，确保接口为 OpenAI 兼容格式
配置入口
设置 → AI 服务
入口名称可能显示为“AI 配置/AI 服务”，以界面为准。
AI 处理方式
声墨的 AI 功能（文本优化、翻译）有两种处理方式：
云端处理（默认）
AI 处理在声墨的云端服务器完成。
- ✅ 无需配置
- ✅ 开箱即用
- ❌ 依赖声墨服务
本地处理
AI 处理由你自己配置的第三方/自建大模型服务完成（OpenAI 兼容接口）。
- ✅ 使用自己的 API Key
- ✅ 可以选择不同模型
- ❌ 需要自己配置
说明：本地处理并非“离线”，仍需访问你配置的服务（内网或公网）。
切换方式：设置 → AI 服务 → AI 处理方式
配置自己的大模型
如果选择「本地处理」，需要配置以下信息：
1. 选择服务商
声墨内置了多个服务商的预设：
国内服务商（推荐国内用户）：
| 服务商 | 特点 |
|---|---|
| DeepSeek | 性价比高，国内首选 |
| 通义千问 | 阿里出品，稳定 |
| 豆包 | 字节出品，响应快 |
| 智谱 GLM | 中文理解强 |
| Mimo | 小米出品 |
海外服务商（需要网络条件）：
| 服务商 | 特点 |
|---|---|
| OpenAI | 生态成熟 |
| Claude | 推理能力强 |
| Gemini | Google 出品 |
| Mistral | 多语言强 |
| Grok | xAI 出品 |
自定义：
- 填写任意 OpenAI 兼容的 API 地址
2. 填写 API Key
每个服务商都需要你去官网注册并获取 API Key。
声墨只会把你的 API Key 存储在本地，不会上传到任何服务器。
3. 选择模型（可选）
每个服务商有推荐的默认模型，你也可以手动指定。
推荐配置
国内用户
- 服务商选择：DeepSeek 或 通义千问
- 获取 API Key（去官网注册）
- 使用默认模型即可
有网络条件的用户
- 服务商选择：OpenAI 或 Gemini
- 获取 API Key
- 推荐模型：
gpt-4o-mini或gemini-2.5-flash-lite
企业用户
- 服务商选择：自定义
- 填写公司内部 AI 网关地址
- 填写对应的 API Key
生效验证
- 回到主界面，开启 AI 优化 或 翻译
- 录一段短语音
- 若有结果变化，说明配置已生效
若提示错误，请检查 API Key、网络与服务商地址。
翻译设置
在 AI 服务页面，还可以配置翻译相关选项：
翻译目标语言
你希望翻译成什么语言。可以选择预设，也可以输入自定义语言。
双语显示
开启后，同时显示原文和译文。
关闭后，只显示译文。
详见 翻译功能。
安全提示
- 不要将 API Key 写进截图、日志或公开文档
- 只在应用内配置，不要随意粘贴到第三方工具
常见问题
API Key 从哪里获取？
每个服务商的官网都有开发者平台，注册后即可获取。
API Key 会不会泄露？
不会。API Key 只存储在你电脑本地，不会上传到声墨服务器。
配置后还是不能用？
检查以下几点：
- API Key 是否正确（没有多余空格）
- 账户是否有余额/额度
- 网络是否能访问该服务商
怎么切回云端处理？
设置 → AI 服务 → AI 处理方式 → 云端处理