AI中转站对接豆包通义千问国产大模型

写在前面

如果你手头有一个 AI 中转站（比如 OneAPI、NewAPI 这类工具），想把豆包和通义千问也加进去统一管理，这篇文章就是为你准备的。
全文只讲实操，不绕弯子，就算之前没接触过 API 配置也能跟着做。

1. 准备工作的三个关键点

在开始配置之前，先确认下面三件事已经就绪：

• 中转站已经正常部署并可以登录。如果你还没有搭建，建议先参照官方文档部署好再回来看。
• 你已经注册了火山引擎（豆包）和阿里云百炼（通义千问）的账号，并完成了实名认证。
• 准备好一个可以接收短信的国内手机号，注册和获取密钥时要用到。

2. 获取豆包和通义千问的 API 密钥

2.1 豆包（火山引擎）

1. 登录 火山引擎控制台，进入「产品与服务」>「火山方舟」>「在线推理」。
2. 点击「创建 API Key」，复制生成的 AK（Access Key）和 SK（Secret Key）。注意：豆包目前使用 AK/SK 鉴权，后续在中转站中需要填成 api-key 格式（通常为 AK:SK 拼接）。
3. 记下你想要的模型名称，例如 doubao-pro-32k、doubao-lite-4k 等，可以从模型列表里复制。

2.2 通义千问（阿里云百炼）

1. 登录 阿里云百炼平台，进入「模型广场」>「通义千问系列」。
2. 创建应用或直接生成 API Key（在「我的 API Key」中生成）。
3. 复制 DASHSCOPE_API_KEY（一串字母数字组合）。
4. 记下模型名称，例如 qwen-max、qwen-plus、qwen-turbo，注意大小写与官方保持一致。

3. 在中转站后台添加渠道

以常用的 OneAPI 为例（其他中转站操作类似，主要是填写“Base URL”和“密钥”）。

1. 登录中转站管理后台，点击左侧「渠道」>「添加渠道」。
2. 名称：自定义，比如“豆包-Pro”或“通义千问-Plus”，方便识别。
3. 类型：选择 OpenAI API（大部分中转站都兼容 OpenAI 格式）。因为豆包和通义千问都提供 OpenAI 兼容接口。
4. Base URL：

• 豆包：https://ark.cn-beijing.volces.com/api/v3 （注意结尾不带斜杠）
• 通义千问：https://dashscope.aliyuncs.com/compatible-mode/v1

1. 密钥：

• 豆包：填写 您的AccessKey:您的SecretKey （中间用英文冒号拼接）
• 通义千问：直接粘贴刚才复制的 DASHSCOPE_API_KEY

1. 模型列表：将你需要的模型名依次填入，每行一个，例如：

• 豆包：doubao-pro-32k、doubao-lite-4k
• 通义千问：qwen-max、qwen-plus、qwen-turbo

1. 其他设置：保持默认，点击「保存」。

特别注意：豆包的 Base URL 可能会随地域变化，请以火山引擎官方文档为准。通义千问的四个地域（北京、上海、杭州、深圳）URL 不同，国内一般使用 dashscope.aliyuncs.com。

4. 验证对接结果

4.1 使用中转站自带的测试功能

在渠道管理页面，找到刚添加的渠道，点击「测试」按钮。
选择一款模型，输入测试提示（例如“你好”），点击发送，如果返回正常结果说明配置成功。

4.2 用命令行快速验证（可选）

如果你习惯用终端，也可以用 curl 测试中转站的统一 API 端点：

curl https://你的中转站地址/v1/chat/completions \
  -H "Authorization: Bearer 你的中转站令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-max",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

返回的 JSON 中应包含 choices 字段，说明对接成功。

5. 高频问题与避坑指南

Q：测试提示模型不存在或返回 404？
A：检查模型名是否准确，注意大小写和带不带版本号。通义千问的模型名官方文档里写的是 qwen-max，不要写成 Qwen-Max。

Q：豆包渠道测试一直报认证失败？
A：确认你的密钥拼接格式是否为 AccessKey:SecretKey，中间是英文冒号，没有空格。另外检查 AK/SK 是否已启用，在火山引擎控制台可以重新生成。

Q：中转站配置后无法连接或超时？
A：检查服务器防火墙是否放行了中转站出站流量，以及 Base URL 是否完整。有些中转站需要额外配置代理，如果你的服务器在国内，一般不需要。

Q：豆包和通义千问的 API 算力配额怎么查？
A：豆包在火山引擎「在线推理」页面查看模型配额；通义千问在阿里云百炼控制台「API 用量」查看。如果提示配额不足，需要申请更高的 TPM（每分钟 Token 数）。

总结

把豆包、通义千问接入 AI 中转站的核心无非三步：拿对密钥、填对地址、选对模型名。
按本文步骤操作后，你就能在一个地方统一调用多个国产大模型，省去来回切换平台的麻烦。
如果配置过程中遇到文中没提到的报错，建议先检查密钥和 Base URL 是否与官方最新文档一致。

延伸阅读：如果你想对接更多国产模型（如文心一言、讯飞星火），操作思路完全相同，只需找到对应的 OpenAI 兼容接口即可。