查询槽位可分配模型¶
读取当前部署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"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
string |
Bearer示例是 |
Bearer加当前环境的管理员令牌;不要同时发送X-API-Key。 |
成功响应¶
{
"models": [
{
"id": "model-example",
"name": "model-example",
"type": "chat_text"
}
]
}
字段 |
类型 |
说明 |
|---|---|---|
|
object(对象数组) |
目录候选;目录未启用时可为空。 |
|
string |
供model_ids和default_model_id使用的ID。 |
|
string |
当前与ID相同的名称。 |
|
string |
与目标槽位允许类型比较。 |
错误响应¶
{
"code": "ErrForbidden",
"msg": "Forbidden"
}
字段 |
类型 |
说明 |
|---|---|---|
|
string |
当前错误代码。 |
|
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。