查询AI Studio服务槽位

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

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

调用前准备

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

请求参数

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

参数

类型

是否必填

说明

Authorization

string

Bearer示例是

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

成功响应

{
  "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": "{}"
    }
  ]
}

字段

类型

说明

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对象字段。

错误响应

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

最后更新于