跳到主要内容
蜂巢
API 控制台
返回创作工作台
登录

开放平台

API 控制台

接入
  • 模型与价格
  • MCP 接入
  • API 接入
  • 模型文档

模型查询升级指南

新版采用轻目录与单模型明细。旧版查询继续可用,你可以按接入方式安排升级。

新版查询流程
按类型或关键词筛选目录,选中模型后读取参数和完整价格,再按原流程预检并调用。已知模型 ID 时直接读取明细,无需遍历全部目录。

本地 MCP 客户端

安装并运行支持新版查询的客户端包后,工具会默认使用新流程。固定旧包继续使用原流程;使用 @latest 的配置在实际获取并启动新版包后采用新流程。

支持新版查询的已发布版本:0.5.0。

升级前保留原包版本与配置;需要回退时恢复原版本并重启客户端。不要在任务结果未知时重复提交付费请求。

远程 MCP

新版连接使用 /api/mcp/v2;妙手使用品牌入口 /api/mcp/v2/miaoshou。添加新版连接并按提示授权,验证目录和模型明细后,再停用旧连接。旧地址保留原默认。

先保留旧配置。若新版连接暂不可用,继续使用旧连接并稍后重试。

API 调用

模型目录改用 GET /api/openapi/v2/models,单模型明细使用 GET /api/openapi/v2/models/{publicModelId}。继续使用原 API 密钥,不需要更换密钥类型。

先验证目录的 models 列表及明细的 model 对象,适配后再替换原查询。完整参数和价格从明细读取;原生成、任务查询和账务接口沿用现有约定。

分页仅在需要更多匹配模型时继续读取 nextCursor。发生查询失败时按提示处理,不自动切换模型或重试付费生成。

MCP 接入API 接入