# 查询槽位可分配模型

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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

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

## 调用前准备

准备当前环境可用的Genesis管理员Bearer令牌；普通个人访问令牌、X-API-Key或工作区Owner不能替代。会话模式还需相应CSRF，详见[AI Studio](../../../../../developer/api/ai-studio/index.md)。这些是账户级管理操作，不需要工作区ID。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

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

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `Authorization` | string | Bearer示例是 | Bearer加当前环境的管理员令牌；不要同时发送X-API-Key。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `models` | object（对象数组） | 目录候选；目录未启用时可为空。 |
| `models[].id` | string | 供model_ids和default_model_id使用的ID。 |
| `models[].name` | string | 当前与ID相同的名称。 |
| `models[].type` | string | 与目标槽位允许类型比较。 |

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `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。

:::::
::::::
:::::::
