模型与 API
Chatbox 自定义 API 怎么填:接入小蓝助手AI与核对费用
在 Chatbox 中使用小蓝助手AI(BlueDoAI)的模型服务,需要添加自定义提供商,填入小蓝平台的 API Key、接口地址和可调用的模型 ID。下面按 OpenAI 兼容文本聊天配置说明,图像、视频、音频不属于这套聊天配置。
更新:2026-11-07
先分清:Chatbox 是工具,API Key 决定用哪家的服务
Chatbox AI 订阅和自带 API Key 是不同的服务方式。使用小蓝平台创建的 Key,应将它填在自定义提供商的 API Key 栏,不是 Chatbox 的许可证或订阅兑换入口。
通过这项自带 Key 配置发出的模型请求,由小蓝平台按对应账户、分组、型号和实际用量计费。Chatbox 自身的订阅与增值功能仍按其条款办理,绑定小蓝 Key 不代表获得这些权益。
自定义提供商的字段这样填写
打开 Chatbox 的设置,进入“模型提供方”,点击添加并选择“添加自定义提供商”。名称可写“小蓝助手AI”,API 模式选择“OpenAI API 兼容”。移动端通常需要先展开左侧菜单;版本不同,入口文字和位置可能略有差异。
如果当前版本将 API Host 和 API Path 分开填写,使用下面这组值。这里只是填写参数,不需要公开你的 Key。
- API Key:你在小蓝平台创建、具有目标分组权限的密钥。
- API Host:https://api.bluedoai.com/v1
- API Path:/chat/completions
- 完整聊天请求地址:https://api.bluedoai.com/v1/chat/completions
- 模型 ID:从小蓝平台当前可调用目录中复制完整技术 ID,不用页面上的中文展示名代替。
地址填了,为什么还会找不到接口?
常见原因是把完整请求地址又填进了 API Host,或者 Host 和 Path 两边都带了 /v1。核对工具最终拼出的地址,应该是上面的完整聊天请求地址,/v1 和 /chat/completions 都只出现一次。
不要把官网首页、模型广场网址或登录页填作 API Host。如果你的版本只有一个 Base URL 输入框,应先核对该版本如何追加路径,再按它的字段说明填写;不要把不同版本的配置方式混用。
模型 ID、分组和上下文要一起核对
在自定义提供商的模型列表中添加模型,类型选择聊天。技术 ID 应完整保留,包括已有的供应商前缀和日期;显示名称可以另填,不能通过修改 ID 来给模型改名。
公开模型广场用于查看型号、价格和能力;你实际能调用哪些模型,还取决于 Key 所属分组与权限。这里应选择当前明确支持 OpenAI Chat Completions 的文本型号,不把视频或其他媒体型号塞进聊天列表。
上下文窗口、最大输出 Token 数等参数,按所选型号和当前分组的说明填写。不能用另一款同名模型的参数,也不应把最大输出任意调大。保存后的“检查”和正式发送消息都可能发出接口请求,需按服务规则核对用量。
想用优惠算力,先看这款模型的实际价格
小蓝助手AI提供官方满血模型与按型号的算力优惠。选定型号后,到实时模型广场核对对应分组、输入价、输出价及适用的缓存或长度分档规则,不把一款模型的优惠写成所有型号的统一折扣。
同样一段提问,费用也会受输出长度和历史消息影响。Chatbox 保存了聊天记录,不代表下次请求只发送你刚输入的一句话;实际携带的上下文会影响输入用量。新话题可另开对话,不需要的历史和附件不要一直带入。
最终核对的是小蓝控制台的用量与账单,不以回答中的自报身份、工具显示的模型别名或一个宣传倍率判断实际型号与总费用。价格、计费单位和可用状态以实时模型广场及账户适用条件为准。
配置后报错,先留原错误再排查
先保存错误原文、发生时间、所选分组和完整模型 ID,再核对请求地址及 Key 的状态和权限。截图前遮住 API Key,不把完整密钥发到群聊或公开评论区。
认证失败、余额或配额不足、模型不可用和请求参数不支持,需要分别处理。根据错误类型逐项核对后,再决定是否重试、切换模型或更换 Key。需要协助时,可通过小蓝官网联系页提交已去敏的信息。
企业采购与其他任务
企业可通过小蓝官网咨询模型 API 的对公采购与发票。需要跨应用处理多步骤工作,可另行了解小蓝助手 Blue 的任务能力;本地化部署、培训和服务按具体项目确认。
本文是小蓝助手自有接入说明,配置字段参考 Chatbox 官方指南,不是 Chatbox 官方推荐、收录或合作声明。