<span id="列出嵌入路由模型"></span>

# List embedding routing models

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

Workspace declarations enter this list only with at least one ONLINE endpoint having a nonempty address.


```http
GET https://api.moi.matrixorigin.cn/v5/embedding/models
```

<span id="调用前准备"></span>

## Before you call this API

Set `BASE_URL` to the product API prefix `https://api.moi.matrixorigin.cn/v5`; use the corresponding product API URL for a dedicated deployment.

[Configure identity, workspace, and model information in the same environment](objects.md#prepare).

<span id="请求"></span>

## Request

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

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

:::::
:::::{tab-item} Parameters

| Parameter | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Workspace-ID` | Headers | string | Yes | Workspace ID in the same environment. |
| `service_slot` | Queries | string | No | Registered service slot ID; omission skips slot filtering. |

Workspace declarations enter this list only with at least one ONLINE endpoint having a nonempty address. System and TaaS models satisfying permission scope are merged separately. Endpoint status still does not establish actual connectivity. The type query key does not change this entry point's fixed embedding type.

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

<span id="成功响应"></span>

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "models": [
      {
        "model": "bge-m3",
        "backend_id": 13,
        "backend_name": "workspace-embedding",
        "model_type": "embedding",
        "source": "workspace",
        "system_default": false
      }
    ]
  }
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | string | OK on success. |
| `data` | object | [Model, probe, or settings result](objects.md#response). |

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

<span id="错误响应"></span>

## Error responses

[States and errors](objects.md#errors) distinguishes string and numeric protocols. Confirm probe candidates, persistence, and actual inference separately.
