列出路由模型

列表合并当前可读工作区声明与权限范围允许的系统/部署模型。

GET https://api.moi.matrixorigin.cn/v5/models

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

配置同环境身份、工作区和模型信息。

请求

curl --request GET \
  "$BASE_URL/models" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

参数

位置

类型

必填

说明

X-Workspace-ID

请求头

string

是

同环境工作区 ID。

type

查询

string

否

默认 chat;支持 chat/vision/ocr/reasoning/embedding/rerank,embeddings 是此入口的 embedding 别名。

service_slot

查询

string

否

已登记服务槽 ID;按其配置进一步过滤,不是任意场景名。

列表合并当前可读工作区声明与权限范围允许的系统/部署模型。系统/TaaS 补充要求集合过滤为 all;受限对象读取不应据空结果推断全局无模型。rerank 当前返回空;embedding 转向嵌入列表规则。结果不构成模型能力或实际推理成功证明。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "models": [
      {
        "model": "chat-example",
        "backend_id": 12,
        "backend_name": "workspace-llm",
        "model_type": "chat",
        "source": "workspace",
        "system_default": false
      }
    ]
  }
}

字段

类型

说明

code

string

成功为 OK。

data

object

模型、探测或设置结果。

错误响应

状态与错误区分字符串与数值协议;探测候选、保存与实际推理分别确认。

最后更新于