模型供应商与 API 密钥配置

优智AI 支持两种方式使用大模型：

1. 平台模型（推荐普通用户）：直接使用平台已接入的模型，按积分/套餐计费，无需任何配置。
2. 自带供应商 Key（BYOK，适合有自己 Key 的用户/团队）：在用户中心配置你自己的模型供应商连接，智能体通过你的 Key 调用上游模型。

方式一：直接使用平台模型

注册登录后默认可用，无需配置 API Key：

1. 进入智能体对话或任意 AI 工具
2. 在模型选择器中挑选平台提供的模型（入门级、专业级、多模态等）
3. 按实际消耗扣积分；免费额度用完后可在定价页订阅套餐或充值

方式二：配置自己的模型供应商（BYOK）

基本概念

• 供应商（Provider）：一个上游模型账户，例如"我的 DeepSeek""我的火山方舟"
• 连接（Connection）：供应商下一条可独立调用的通道，包含协议格式（format）、接口地址（apiBaseUrl）和密钥（apiKey）
• 一个供应商下可以挂多条连接（多 Key 轮询/灾备、多个接口地址），还可以指定默认模型和可用模型列表

配置步骤

1. 登录后点击右上角头像，进入个人中心
2. 找到"模型供应商 / LLM Providers"板块，点击新建供应商
3. 填写：
   • 协议格式：选择上游接口协议（OpenAI 兼容、Anthropic 等），不确定时选 OpenAI 兼容
   • 接口地址（apiBaseUrl）：供应商的 API 基础地址，例如 https://api.deepseek.com
   • API 密钥（apiKey）：在模型供应商官网申请的 Key（形如 sk-...）
4. （可选）添加多条连接实现多 Key 轮询；设置默认模型
5. 保存后点击验证 / 测试连接，系统会调用一次上游确认 Key 和地址可用
6. 回到智能体对话，在模型选择器中选择该供应商下的模型

常见 OpenAI 兼容配置示例

具体地址和模型名以各供应商官方文档为准。

密钥安全

• API Key 只用于向你配置的上游供应商发起请求，页面默认只显示后 4 位
• 不要把 Key 写进公开的网页、截图或聊天内容
• 怀疑泄露时，立刻到供应商官网吊销并重置 Key，再回到这里更新连接
• 可以随时在供应商列表中停用或删除某条连接

常见错误

连接验证失败 / 调用报 401

• Key 复制时多了空格，或 Key 已被吊销/欠费 → 到供应商官网核对、重新生成
• 接口地址填错（多了 /v1、多了斜杠或少了域名）→ 对照供应商文档
• 账户在供应商侧余额不足 → 充值上游账户

能连通但模型列表为空 / 报模型不存在

• 该供应商需要手动填写模型名 → 在供应商设置中把要用的模型加进可用模型列表
• 模型名拼写与上游不一致（大小写、版本号）→ 复制上游控制台的精确模型 ID

频繁超时

• 接口地址在当前网络环境访问不稳定 → 更换网络或供应商区域
• 一个供应商下添加多条连接，可降低单点故障影响

429 限流

• 上游账号自身的速率/额度限制 → 降低并发，或在供应商侧提升配额
• 平台模型报 429 → 稍后重试；高频使用建议升级套餐

企业接入

需要统一模型网关、团队共享额度、私有化或 SSO 的企业用户，请通过平台内商务微信或邮箱 qyd159@163.com 联系商务。

相关资源

• 平台介绍与注册
• 快速开始
• 常见问题

阅读时间: 6分钟难度等级: 初级