查询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"
参数 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
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": "{}"
}
]
}
字段 |
类型 |
说明 |
|---|---|---|
|
object(对象数组) |
当前源码注册12个槽位,顺序及定义见共享页;此接口不分页。 |
|
string |
功能槽位标识。 |
|
string |
当前注册定义的名称。 |
|
string |
hidden或selectable,描述前端是否让用户选模型。 |
|
string(字符串数组) |
允许分配的目录模型类型。 |
|
boolean |
是否配置了非空模型列表;不等于模型健康或当前凭据可调用。 |
|
string |
默认模型ID,未配置时为空字符串。 |
|
string |
可选;当前按模型ID显示。 |
|
object(对象数组) |
有序模型列表,未配置时为空。 |
|
string |
候选目录模型ID。 |
|
string |
当前投影名称。 |
|
string |
列表可由目录补充;写入响应当前可能为空字符串。 |
|
integer |
列表中的零基位置。 |
|
string |
可选额外JSON文本,不是JSON对象字段。 |
错误响应¶
{
"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。