查询槽位可分配模型

读取当前部署TaaS公开目录快照中的模型ID和类型。随后按目标槽位allowed_model_types选择;候选存在不等于任一槽位都可用。

GET https://api.moi.matrixorigin.cn/v5/admin/aistudio/service-slots/candidates

调用前准备

准备当前环境可用的Genesis管理员Bearer令牌;普通个人访问令牌、X-API-Key或工作区Owner不能替代。会话模式还需相应CSRF,详见AI Studio。这些是账户级管理操作,不需要工作区ID。

请求参数

curl --get "https://api.moi.matrixorigin.cn/v5/admin/aistudio/service-slots/candidates" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN"

参数

类型

是否必填

说明

Authorization

string

Bearer示例是

Bearer加当前环境的管理员令牌;不要同时发送X-API-Key。

成功响应

{
  "models": [
    {
      "id": "model-example",
      "name": "model-example",
      "type": "chat_text"
    }
  ]
}

字段

类型

说明

models

object(对象数组)

目录候选;目录未启用时可为空。

models[].id

string

供model_ids和default_model_id使用的ID。

models[].name

string

当前与ID相同的名称。

models[].type

string

与目标槽位允许类型比较。

错误响应

{
  "code": "ErrForbidden",
  "msg": "Forbidden"
}

字段

类型

说明

code

string

当前错误代码。

msg

string

当前失败阶段的说明;该示例为HTTP Forbidden文本。

HTTP / code

条件与处理

400 / ErrParamInvalid

槽位、模型、默认值、JSON文本或日志数量参数不合法。

401 / Unauthorized

身份无效或使用X-API-Key等不适用认证方式。

403 / ErrForbidden

无Genesis管理员事实。

503 / ErrServiceUnavailable

已分类的必要身份/配置依赖不可用。

500 / ErrServer或InternalServerError

内部或身份阶段失败;写入错误后先回读,不能推断回滚。

错误使用code/msg,成功却是原始对象。不同失败阶段可能使用不同字符串code;不虚构每个校验错误的独立机器reason。

最后更新于