云端 API Key 配置:Operit 接入 OpenAI / Claude / Gemini / DeepSeek
支持的云端模型供应商
Operit v1.12.x 支持主流 AI 供应商的 API:
| 供应商 | 接入方式 | 备注 |
|---|---|---|
| DeepSeek | OpenAI 兼容 API | 国内速度快,成本低,社区推荐 |
| OpenAI | 官方 API | GPT-4o / GPT-4o mini 等 |
| Anthropic | 官方 API | Claude 3.5 Sonnet / Opus 等 |
| 官方 API | Gemini 1.5 Pro / Flash 等 | |
| 智谱 AI | 官方 API | AutoGLM 视觉模型同一家 |
| xAI | 官方 API | Grok 系列 |
| Ollama | OpenAI 兼容 API | 自托管本地模型的 API 暴露 |
| NVIDIA | 官方 API | 企业级推理 |
| OpenRouter | 聚合 API | 一站式接多家模型 |
| LMStudio | OpenAI 兼容 API | 本地桌面 LLM 客户端暴露 API |
配置步骤
第一步:在 Operit 里新建模型配置
- 打开 Operit 侧栏 → 模型配置(或 AI 模型设置)
- 点击「新建配置」或「添加模型」
- 选择供应商(如 DeepSeek / OpenAI / Claude 等)
- 填入对应的 API Key
第二步:获取 API Key
API Key 从对应供应商的控制台申请:
- DeepSeek:platform.deepseek.com → API Keys → Create New Key
- OpenAI:platform.openai.com → API Keys → Create new secret key
- Anthropic:console.anthropic.com → API Keys → Create Key
- Google:console.cloud.google.com → 创建 API Key(需开通 Generative AI API)
Key 都是一长串字符,复制粘贴时注意不要带前后空格或换行符。
第三步:选择具体模型
每个供应商可能提供多个模型。Operit 会自动拉取模型列表,也可以手动填写模型 ID。社区主流选择:
- 日常对话:DeepSeek-V3 / GPT-4o mini / Claude Haiku / Gemini Flash
- 复杂推理:GPT-4o / Claude 3.5 Sonnet / Gemini Pro / DeepSeek-R1
- 视觉理解:GPT-4o(支持 vision)/ Claude 3.5 Sonnet(vision)
第四步:测试连接
填完配置后点「测试」或直接在对话里发一条消息。如果返回正常回复就通了;报错则检查 Key、模型 ID、网络连接。
DeepSeek 推荐配置(社区主流)
DeepSeek 在国内速度快、成本低,是不少中文用户的首选:
供应商:DeepSeek
API Key:从 platform.deepseek.com 获取
模型 ID:deepseek-chat(主力)或 deepseek-reasoner(R1 推理)
API Base:Operit 自动填 https://api.deepseek.com/v1
星火 API / 第三方 API 中转
有些第三方 API 中转服务(如星火 API 等)提供 OpenAI 兼容接口。配置方式:
供应商:OpenAI(选兼容模式)
API Key:第三方服务提供的 Key
API Base:第三方服务提供的地址
模型 ID:第三方支持的模型名
常见问题
API Key 报错「Invalid API key」
- 复制 Key 时有没有带空格或换行符
- Key 是否有效(有些平台 Key 有时效或额度限制)
- 部分供应商要求在 API Base 里指定具体端点
连接超时
- 手机网络是否正常(Operit 在 Ubuntu chroot 里也能联网,确认两边都通)
- 部分供应商(OpenAI、Anthropic)在国内需要境外网络
- 切到 DeepSeek 等国内供应商测试
模型 ID 不认识
- 手动填模型 ID 时注意拼写(
deepseek-chat不是DeepSeek-Chat) - 最新模型可能需要 Operit 版本升级后才支持
额度用完
- 部分供应商有免费额度,用完需要充值
- DeepSeek 目前有免费额度,GPT-4o 几乎都是付费的