# 查询AI Studio服务槽位

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

查看各功能的模型允许列表、默认模型和选择方式。未配置槽位也会返回，不以configured推断模型健康。

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

## 调用前准备

准备当前环境可用的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" \
  -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
{
  "slots": [
    {
      "slot_id": "parse",
      "name": "Document parse",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "chat_multimodal",
        "ocr"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "audio_parse",
      "name": "Audio parse",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "asr"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "extract",
      "name": "Information extract",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "img_parse",
      "name": "Image parse",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "chat_multimodal",
        "ocr"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "ai_infer",
      "name": "AI inference",
      "frontend_behavior": "selectable",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "embed_text",
      "name": "Text embedding",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "embedding_text"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "embed_img",
      "name": "Image embedding",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "embedding_multimodal",
        "embedding_text"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "rerank",
      "name": "Rerank",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "rerank_text",
        "rerank_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "workflow",
      "name": "Intelligent workflow",
      "frontend_behavior": "selectable",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "nl2sql",
      "name": "NL2SQL",
      "frontend_behavior": "hidden",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "knowledge_qa",
      "name": "Knowledge Q&A and RAG",
      "frontend_behavior": "selectable",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": false,
      "default_model_id": "",
      "models": []
    },
    {
      "slot_id": "agent_chat",
      "name": "Agent chat",
      "frontend_behavior": "selectable",
      "allowed_model_types": [
        "chat_text",
        "chat_multimodal"
      ],
      "configured": true,
      "default_model_id": "model-example",
      "models": [
        {
          "id": "model-example",
          "name": "model-example",
          "type": "chat_text",
          "position": 0
        }
      ],
      "default_model_name": "model-example",
      "extra_json": "{}"
    }
  ]
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `slots` | object（对象数组） | 当前源码注册12个槽位，顺序及定义见共享页；此接口不分页。 |
| `slots[].slot_id` | string | 功能槽位标识。 |
| `slots[].name` | string | 当前注册定义的名称。 |
| `slots[].frontend_behavior` | string | hidden或selectable，描述前端是否让用户选模型。 |
| `slots[].allowed_model_types` | string（字符串数组） | 允许分配的目录模型类型。 |
| `slots[].configured` | boolean | 是否配置了非空模型列表；不等于模型健康或当前凭据可调用。 |
| `slots[].default_model_id` | string | 默认模型ID，未配置时为空字符串。 |
| `slots[].default_model_name` | string | 可选；当前按模型ID显示。 |
| `slots[].models` | object（对象数组） | 有序模型列表，未配置时为空。 |
| `slots[].models[].id` | string | 候选目录模型ID。 |
| `slots[].models[].name` | string | 当前投影名称。 |
| `slots[].models[].type` | string | 列表可由目录补充；写入响应当前可能为空字符串。 |
| `slots[].models[].position` | integer | 列表中的零基位置。 |
| `slots[].extra_json` | string | 可选额外JSON文本，不是JSON对象字段。 |

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

## 错误响应

:::::::{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。

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