ClariRec API Key 添加教程
默认系统 OCR 不需要 Key。只有可选的 BYOK 云端 OCR（执行需 Pro）、云端翻译或 Pro 公式识别才需要。配置与连接测试免费。
步骤
- 菜单栏 → 设置 → Providers / 引擎
- 打开 文字识别、翻译 或 公式识别
- 选择引擎，填写右侧内联面板
- 测试连接 → 保存 / 设为当前引擎
OCR 与翻译引擎独立。共享密钥（如 Custom API / Qwen）会在相关分段显示为已配置。
引擎一览
| 引擎 | OCR | 翻译 | 公式 (Pro) | 填写字段 | 密钥入口 |
|---|---|---|---|---|---|
| Custom API | 支持 | 支持 | 支持 | Key、基础 URL、模型 | 你的兼容端点 |
| Qwen（通义千问） | 支持 | 支持 | 支持 | Key，可选基础 URL | DashScope |
| Mistral AI | 支持 | 支持 | 不支持 | Key，可选基础 URL | Mistral |
| Azure 文档智能 | 支持 | 不支持 | 不支持 | Key、Endpoint | Azure |
| 百度 OCR | 支持 | 不支持 | 不支持 | Key、Secret Key | 百度 OCR |
| Google Cloud Vision | 支持 | 不支持 | 不支持 | Key | Google Cloud |
| DeepL | 不支持 | 支持 | 不支持 | Key，可选 endpoint | DeepL |
| Mercury-2 | 不支持 | 支持 | 不支持 | 仅 Key | Inception Labs |
| OpenAI / Anthropic / DeepSeek / 智谱 GLM / Grok / OpenRouter | 不支持 | 支持 | 不支持 | 仅 Key（内置端点） | 各服务商控制台 |
内置仅翻译引擎通常只需 API Key。控制台、模型与额度会变——购买前以服务商当前文档为准。
Custom API： 兼容 OpenAI Chat Completions。OCR/公式需视觉模型；翻译用文本模型即可。
公式（Pro）： 在「公式识别」中配置 Custom API 或 Qwen → 解锁 Pro → 测试公式。额度由服务商计费，不含在 Pro 内。
腾讯云 OCR / TMT 目前不是内置引擎。
隐私
密钥存在 macOS 钥匙串。内容仅在你使用对应引擎时直连发往配置端点。ClariRec 不中转。
排查
测试连接失败
检查 Key、端点、额度与地区。Azure/百度请填 ClariRec 要求的第二字段（Endpoint 或 Secret Key）。
不能用于翻译
Azure、百度、Google Vision 仅 OCR。请换翻译引擎或本地/系统翻译。
Custom API 能保存但 OCR/公式失败
使用支持图片的模型与兼容 Chat Completions 的端点。公式还需稳定返回结构化 JSON。
相关
常见问题 · 本地 OCR · 截图翻译 · LaTeX · 隐私政策
