返回文档

API Key 配置教程

2026-05-01

API Key 配置教程

本文教你在 Doforu 里配置 AI 模型,就像教你怎么填一张表单一样简单。


1. 先认识设置页面

点击 Doforu 界面左下角的 设置按钮,弹出设置窗口,默认就在 API Key 页面。

点击设置按钮

API Key 配置页面,显示厂商选项

API Key 配置示例

2. 支持的模型厂商

Doforu 支持 OpenAI 兼容 和 Anthropic 原生 两种协议。以下是所有支持的 AI 厂商。

快速开始: 中国用户推荐 硅基流动 或 智谱 AI;想要最强模型选 OpenAI 或 Anthropic Claude。

OpenAI 兼容协议

适用于大多数 AI 厂商。选择 Provider: OpenAI 兼容。

厂商 Base URL 模型 价格 区域 适用场景 获取 Key
OpenAI • GPT-5.5 api.openai.com/v1 gpt-5.5 $5 / $30 US 旗舰最强模型 注册
OpenAI • GPT-5.4 api.openai.com/v1 gpt-5.4 $2.50 / $15 US 生产主力、1M 上下文 注册
OpenAI • GPT-5.4-Mini api.openai.com/v1 gpt-5.4-mini $0.75 / $4.50 US 高性价比通用任务 注册
OpenAI • o4-mini api.openai.com/v1 o4-mini $0.55 / $2.20 US 经济推理、数学、逻辑 注册
OpenAI • GPT-4.1 api.openai.com/v1 gpt-4.1 $2 / $8 US 可靠长上下文生产模型 注册
Google Gemini • 2.5 Flash generativelanguage.googleapis.com/v1beta/openai/ gemini-2.5-flash $0.30 / $2.50 US 混合推理、1M 上下文 注册
Google Gemini • 2.5 Flash-Lite generativelanguage.googleapis.com/v1beta/openai/ gemini-2.5-flash-lite $0.10 / $0.40 US 极低成本、高吞吐量 注册
Google Gemini • 3 Flash Preview generativelanguage.googleapis.com/v1beta/openai/ gemini-3-flash-preview $0.50 / $3.00 US 前沿智能、快速响应 注册
Google Gemini • 3.1 Pro Preview generativelanguage.googleapis.com/v1beta/openai/ gemini-3.1-pro-preview $2 / $12 US 最强多模态、Agent 能力 注册
DeepSeek • V4 Flash api.deepseek.com deepseek-v4-flash $0.14 / $0.28 CN Agent 编程、超低价格 注册
DeepSeek • V4 Pro api.deepseek.com deepseek-v4-pro $1.74 / $3.48 CN 最强能力 注册
DeepSeek • V3 系列 api.deepseek.com deepseek-v3.2 / deepseek-v3 / deepseek-chat $0.14 / $0.28 CN 经典稳定、价格极低 注册
Anthropic • Claude Sonnet 4.6 api.anthropic.com/v1 claude-sonnet-4.6 / claude-3-5-sonnet-20241022 $3 / $15 US 生产环境最佳平衡 注册
Anthropic • Claude Opus 4.7/4.6 api.anthropic.com/v1 claude-opus-4.7 / claude-opus-4.6 $5 / $25 US 最适合对话、超长上下文 注册
Anthropic • Claude Haiku 4.5 api.anthropic.com/v1 claude-haiku-4.5 $1 / $5 US 快速轻量任务 注册
OpenRouter openrouter.ai/api/v1 owl-alpha / openai/gpt-5.5 / openai/gpt-5.4 / anthropic/claude-opus-4.7 / anthropic/claude-sonnet-4.6 $2.50 / $10 US 聚合多模型、切换方便 注册
xAI (Grok) api.x.ai/v1 grok-4.3 / grok-4 / grok-4.1-fast $1.25 / $2.50 US 快速推理、竞争力价格 注册
TogetherAI api.together.xyz/v1 meta-llama/Llama-3.3-70B-Instruct / mistralai/Mixtral-8x22B $0.6 / $1.2 US 开源大模型云托管与推理加速 注册
Groq api.groq.com/openai/v1 llama-3.1-70b-versatile / mixtral-8x7b-32768 / nemotron-3-super $0.2 / $0.4 US 极速推理(LPU芯片)、超低延迟 注册
腾讯混元 api.hunyuan.cloud.tencent.com/v1 hunyuan-turbos-latest / hunyuan-pro / hunyuan-lite $0.4 / $1.2 CN 腾讯生态、中文能力强 注册
StepFun api.stepfun.com/v1 step-3.5-flash $0.3 / $0.6 CN 中文生态、稳定 注册
MiniMax api.minimax.chat/v1 minimax-m2.7 $0.2 / $0.4 CN 性价比高、性能好 注册
硅基流动 api.siliconflow.cn/v1 Qwen/Qwen3.5-35B-A3B / DeepSeek-V3.2 / DeepSeek-V4 $0.99 / $1.99 CN 国内可用、免费额度 注册
阿里云百炼 dashscope.aliyuncs.com/compatible-mode/v1 qwen3.7-max / qwen-max / qwen-plus $0.5 / $2 CN 阿里生态、稳定可靠 注册
智谱 AI open.bigmodel.cn/api/paas/v4 glm-5.1 / glm-4 / glm-4-flash $0.1 / $0.3 CN 国内可用、中文优化 注册
月之暗面 Kimi api.moonshot.cn/v1 moonshot-k2.6 / moonshot-v1-128k $0.6 / $1.2 CN 超长上下文支持 注册
字节豆包 ark.cn-beijing.volces.com/api/v3 doubao-seed-2.0-pro / doubao-pro / doubao-lite $0.2 / $1 CN 性价比高、稳定 注册

Anthropic 原生协议

用于 Claude 模型。选择 Provider: Anthropic 原生。

厂商 Base URL 模型 价格 区域 适用场景 获取 Key
Anthropic • Claude Sonnet 4.6 api.anthropic.com/v1 claude-sonnet-4.6 / claude-3-5-sonnet-20241022 $3 / $15 US 生产环境最佳平衡 注册
Anthropic • Claude Opus 4.7 api.anthropic.com/v1 claude-opus-4.7 $5 / $25 US 最适合对话、超长上下文 注册
Anthropic • Claude Haiku 4.5 api.anthropic.com/v1 claude-haiku-4.5 $1 / $5 US 快速轻量任务 注册

注意: Anthropic 原生协议不需要勾选"OpenAI 兼容"。

OpenRouter(统一多模型网关)

OpenRouter 是一个单一 API 代理,让你通过一个 API Key 访问来自多家厂商的 200+ 模型——包括 OpenAI、Anthropic、Google、Meta、DeepSeek 等。你只需配置一次,之后通过更改模型 ID 来切换模型,无需管理多个厂商账号。

模型 ID 格式说明: OpenRouter 使用 厂商/模型名 格式。例如:

  • openai/gpt-5.5 — OpenAI 的 GPT-5.5
  • anthropic/claude-sonnet-4.6 — Anthropic 的 Claude Sonnet 4.6
  • google/gemini-2.5-flash — Google 的 Gemini 2.5 Flash
  • openai/gpt-5.4 — OpenAI 的 GPT-5.4
  • anthropic/claude-opus-4.7 — Anthropic 的 Claude Opus 4.7
  • meta-llama/llama-3.3-70b-instruct — Meta 的 Llama 3.3(通过 OpenRouter)

浏览所有可用模型:openrouter.ai/models。

快速配置(4 步):

  1. 在 openrouter.ai 注册并获取 API Key
  2. 在 Doforu 中添加新配置,Provider 选择 OpenAI 兼容
  3. Base URL 设置为 https://openrouter.ai/api/v1
  4. 输入你想要的模型 ID(如 openai/gpt-5.5)和你的 API Key

为什么选择 OpenRouter? 一个 Key、一个 URL、200+ 模型。适合想要尝试不同模型但不想管理多个厂商账号的用户。


3. 配置步骤

Step 1: 打开设置

点击左下角的 设置按钮,弹出设置窗口(默认:API Key 页面)。

Step 2: 添加新配置

点击右上角 + 添加新配置。

Step 3: 选择协议类型

  • OpenAI 系列模型 → 选择 OpenAI 兼容
  • Claude 模型 → 选择 Anthropic 原生

Step 4: 填写配置

从上方的表格中复制对应的 Base URL 和 Model。

Step 5: 粘贴 API Key

从厂商网站复制 API Key,粘贴到输入框中。

Step 6: 保存配置

  1. 点击 测试连接 → 等待 2-3 秒
  2. 显示绿色成功 → 点击 保存
  3. 模型会出现在右上角的模型选择器中

4. 配置模板

模板 A: OpenAI 兼容

字段 值
Provider OpenAI 兼容
Base URL 厂商的 Base URL(如 https://api.openai.com/v1)
Model 厂商的示例模型(如 gpt-4o)
API Key 你的 API Key
配置名称 任意名称(如"My GPT-4o")

模板 B: Anthropic 原生(仅限 Claude)

字段 值
Provider Anthropic 原生
OpenAI 兼容 不要勾选
Base URL https://api.anthropic.com/v1
Model claude-sonnet-4.6
API Key 你的 Anthropic API Key
配置名称 任意名称(如"My Claude")

模板 C: OpenRouter(多模型网关)

字段 值
Provider OpenAI 兼容
Base URL https://openrouter.ai/api/v1
Model 厂商模型 ID(如 openai/gpt-5.5)
API Key 你的 OpenRouter API Key(从 openrouter.ai/keys 获取)
配置名称 任意名称(如"OpenRouter GPT-5.5")

5. 连接测试与故障排除


连接测试对话框,显示测试结果


测试结果

结果 含义 解决方案
绿色"连接成功" 配置正确 保存并使用
红色"连接失败" 配置有误 检查以下项目

故障排除

1. Base URL 错误

  • 确保包含 https:// 前缀
  • 检查斜杠 / 是否多余或缺失

2. API Key 错误

  • 确保复制完整(没有多余空格)
  • 检查 Key 是否过期或已禁用

3. 网络问题

  • 部分厂商需要 VPN 才能访问
  • 检查代理是否阻止了请求

4. 模型名称错误

  • 确认模型名称完全匹配
  • 部分厂商包含版本号(如 gpt-4o-2024-08-06)

6. 常见问题

Q:可以同时配置多个厂商吗?

A: 可以。点击"添加新配置"添加多个厂商,然后在模型选择器中切换。

Q:哪个厂商适合新手?

A: 中国用户:硅基流动(免费额度,即刻可用)。海外用户:OpenAI(最流行、最强模型)。

Q:我的 API Key 安全吗?

A: 你的 API Key 存储在本地或你配置的服务器上。Doforu 不会收集或上传你的 Key。

Q:需要 VPN 吗?

A: 取决于厂商地区:

  • 美国厂商(OpenAI、Google Gemini、Anthropic Claude、OpenRouter、xAI):需要 VPN
  • 中国厂商(DeepSeek、硅基流动、阿里云百炼、智谱 AI、Kimi、豆包):国内可用,无需 VPN

Q:如何选择模型?

A: 推荐新手起步模型:

  • gpt-5.5 / gpt-5.4-mini(OpenAI)
  • deepseek-chat(DeepSeek - 最低价格)
  • glm-4-flash(智谱 AI - 中国免费额度多)

Q:应该使用 OpenRouter 还是直接配置各个厂商?

A: 如果你想快速尝试多种不同模型,选择 OpenRouter——一个 Key、一次配置、200+ 模型任你切换。如果你有大量生产使用需求,想为特定厂商获得绝对最低的价格,直接配置该厂商可能更便宜。