AI中转站批量导入上游模型渠道密钥完整教程
什么时候需要给AI中转站批量导入渠道密钥？
如果你运维的AI中转站（例如 One-API、New-API）已经对接了多个上游供应商（硅基流动、阿里通义、百度文心等），每次新增一批密钥都要手动填表，效率很低。
特别是当上游调整策略、重新下发大量密钥时，批量导入能一次性把几十甚至上百条渠道密钥写进去，避免人工错漏。
本文以 One-API（常见的中转站项目） 为例，讲解从准备文件到完成导入的完整流程，不依赖命令行，只需在后台操作。
开始前要准备好哪些东西？
- AI中转站的管理员账号：确保你拥有“渠道管理”或“令牌管理”权限。
- 密钥清单：从上游拿到的 API Key 列表，每一条包含模型标识（或渠道名称）和对应的密钥。
- 一个文本编辑器（记事本、VS Code 等），用于制作导入文件。
- 文件格式意识：One-API 的批量导入默认使用 CSV（逗号分隔值） 文件，第一行是列名，后续每行一条密钥。
如果你用的中转站是不同的项目（如 New-API 或 LobeChat 自建站），操作入口可能略有不同，但文件格式原理相似。
一步步教你在后台完成批量导入
1. 准备 CSV 文件
打开记事本，新建一个文件，输入以下内容（注意列名不能改）：
type,name,key,models,group,model_mapping,max_tokens,other
1,硅基流动,sk-xxx,glm-4|qwen-turbo,default,,4096,
1,阿里通义,sk-yyy,qwen-max,default,,8192,
1,百度文心,sk-zzz,ERNIE-4.0,default,,4096,- type：渠道类型，1 表示上游模型，2 表示自定义令牌等，一般使用 1。
- name：你自己命名的渠道名，不要重复。
- key：实际的 API Key。
- models：该密钥可以调用的模型名，多个用英文竖线分隔。
- group：分组（默认写 default）。
- model_mapping：模型映射，留空即可。
- max_tokens：最大 Token 数，按上游限制填写，如果不知道可填 4096。
- other：其他参数，通常留空。
确认无误后，将文件另存为 channels.csv，编码选择 UTF-8（记事本保存时选择编码为 UTF-8）。
2. 登录中转站后台并找到导入入口
- 使用管理员账号登录 One-API 后台（地址通常是
http://你的域名/admin）。 - 在左侧菜单找到 渠道管理，点击进入。
- 在渠道列表页面上方，你会看到 批量导入 或 导入 按钮（图标通常是向上箭头或下载箭头）。
- 点击后，会弹出文件选择框，选择刚才保存的
channels.csv文件。 - 系统会预览即将导入的数据行数，确认无误后点击 确认导入。
3. 导入完成后的状态检查
导入完成后，页面会返回提示信息，例如“成功导入 3 条渠道”或“失败 1 条”。
如果出现失败，请参考下一节排错。
高频报错与避坑指南
问题1：导入后显示“CSV格式错误”
原因：列名拼写错误或分隔符不是英文逗号。
注意不要用中文逗号，不要有多余空格。
建议直接用上面给的模板修改。
解决：重新用记事本打开文件，检查第一行是否完全匹配 type,name,key,models,group,model_mapping,max_tokens,other。
问题2：提示“渠道名称重复”
原因：你导入的 name 列中有和已有渠道同名的。
One-API 不允许同名渠道。
解决：在 CSV 中给每个渠道起不同的名字，或者先在后台删除旧渠道再导入。
问题3：导入成功但测试调用报错“无效密钥”
原因：可能 key 列中包含了多余空格或引号。
记事本保存 CSV 时，不要手工加双引号。
如果需要保留密钥中的特殊字符，用文本编辑器确认格式。
解决：用 Excel 或 WPS 打开 CSV 查看每一列的值是否干净，重新保存为 CSV（逗号分隔）。
避坑小提醒
- 不要在 CSV 中混入空行，否则可能被当成一条空记录导致导入异常。
- 如果你有大量模型需要映射，建议先在后台单条测试一个渠道，确认配置无误后再批量导入。
- 部分中转站项目（如 New-API）的导入格式略有不同（列名可能为
channel_type），请先查阅对应项目的 README 或后台提示。
如何验证批量导入是否全部生效？
- 检查渠道列表：回到渠道管理页面，确认刚才导入的几条渠道都在列表中，状态为“已启用”。
- 测试单个渠道：点击渠道右侧的“测试”按钮（如果有），选择模型的测试提示，看能否正常返回结果。
- 通过令牌调用测试：创建一个测试令牌，绑定刚导入的渠道分组，然后用 curl 或 Postman 调用一次，观察返回是否正常。
# 示例：用 curl 测试中转站接口
curl http://你的域名/v1/chat/completions \
-H "Authorization: Bearer 你的测试令牌" \
-H "Content-Type: application/json" \
-d '{"model": "glm-4", "messages": [{"role": "user", "content": "hello"}]}'如果返回正确的 AI 回复，说明导入成功，渠道已正常工作。
如果你正在搭建或维护 AI 中转站，批量导入渠道密钥能省下大量重复劳动。
建议先按本文步骤走通一小批，再逐步扩展到全量密钥，遇到异常时优先回看上面的避坑和高频问题部分。
