Octop 配置胜算云
一、准备工作
开始配置前，请确保已经完成以下准备：
- 已安装并启动 Octop，能够正常进入管理控制台。
- 已注册胜算云账号，并创建 API Key。
- 胜算云账户具有可用余额。
- 已确定需要调用的模型，并获取对应的模型 ID。
二、获取胜算云 API Key
- 打开 胜算云控制台，登录账号。
- 进入API 密钥页面，创建新的 API Key，或使用已有的有效 Key。
- 复制 API Key 并妥善保存，后续配置 Octop 时使用。
- 进入胜算云模型中心，查询目标模型 ID。
三、在 Octop 中添加胜算云模型供应商
步骤 1：进入模型管理
打开 Octop 客户端或 Web 管理控制台，在左侧导航栏找到：管理 → 模型。
该页面用于管理模型供应商、启用模型以及可用模型池。
步骤 2：添加自定义供应商
在模型配置页面，点击【+ 自定义供应商】，新增一个自定义模型供应商。
配置项 | 填写内容 |
供应商名称 | 自定义 |
协议类型 | OpenAI 兼容 / Anthropic / AWS Bedrock |
Base URL | https://router.shengsuanyun.com/api/v1 |
API Key | 胜算云控制台创建的 Key |
注意：如果选择【协议类型】是 Anthropic，Base URL 须去除 /V1，完整 URL 如下：
https://beta-router.shengsuanyun.com/api
步骤 3：添加需要调用的模型
方法一：模型列表中检索
在自定义供应商配置中，点击【获取模型列表】，在下拉列表中检索目标模型，打开模型开关。
方法二：胜算云模型中心中复制模型 ID
点击【+ 添加模型】，进入胜算云模型中心，复制模型 ID，填入到 Octop 中的模型 ID 和模型名称。
模型 ID 必须与胜算云模型中心显示的 ID 完全一致，包括大小写、连字符和版本后缀。
步骤 4：测试连接并保存
完成配置后，点击【测试连接】/⚡️，测试通过后，保存并启用供应商，然后检查新增模型是否出现在页面顶部的【可用模型池】。
注意：连接测试成功，只能说明探测请求成功，并不代表 Octop 专家执行真实任务时一定能够正常调用模型。
四、配置 Octop 专家并开始对话
前面模型配置完成，无法直接对话，还需要进一步配置专家。
步骤 1：检查专家模型配置
返回 Octop 左侧【专家】菜单，选择已有专家或创建新的专家。
确认该专家可以使用刚添加的胜算云模型。具体选择方式取决于 Octop 版本的模型路由设置。
步骤 2：新建对话
返回左侧【对话】菜单，选择目标专家并发送测试消息。
五、常见问题排查
问题 | 可能原因与处理方式 |
连接测试失败 | 核对 API Key、Base URL、网络连接和胜算云可用余额 |
401 Unauthorized | API Key 无效、填写错误或未正确携带认证信息 |
402 insufficient_quota | 账户额度不足，检查余额、待结算费用或额度限制 |
404 Model Not Found | 模型 ID 填写错误或当前 Key 无法访问该模型 |
429 Too Many Requests | 可能触发频率限制或上游并发限制，适当降低请求频率 |
400 Invalid Request | 检查模型协议、请求参数、上下文长度和工具调用格式 |
测试连接通过，但无法新建对话 | 确认供应商已启用、模型已加入模型池、专家模型配置有效 |
提示【开启专家模型】 | 优先检查专家是否已正确绑定可用模型，以及自动路由能否找到符合要求的模型 |
六、接入完成
完成以上步骤后，即可在 Octop 中使用通过胜算云接入的大模型，并根据需要将其用于不同专家的日常对话和任务执行。
使用过程中，建议定期查看胜算云控制台的调用记录与消费情况，合理选择模型，控制实际使用成本。
相关入口