> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Router 管理面模型列表接口

> 列出咏唱引擎 ROUTER 管理面暴露的全部 provider 归属模型。与 OpenAI 数据面的 /v1/models 接口不同。

管理面模型接口返回咏唱引擎 ROUTER 已知的全量模型列表，并标注其归属 provider。这与 OpenAI 兼容的 `/v1/models` 数据面接口相互独立。可用它审计可用模型及其后端归属。

任何已认证调用者均可访问此接口。

## 接口

```http theme={null}
GET /v1/router/models
```

## 认证

使用会话 Cookie 认证，或携带 `Authorization: Bearer <api-key>`。

## 响应

<ResponseField name="items" type="array">
  带 provider 归属的模型列表。

  <Expandable title="items">
    <ResponseField name="id" type="string">
      模型标识符。
    </ResponseField>

    <ResponseField name="provider" type="string">
      服务此模型的 provider 名称。
    </ResponseField>

    <ResponseField name="backend_ref" type="string">
      后端端点或标识符。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://router.example.com/v1/router/models" \
    -H "Authorization: Bearer <api-key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "gpt-4o",
        "provider": "openai",
        "backend_ref": "openai/gpt-4o"
      },
      {
        "id": "gpt-4o-mini",
        "provider": "openai",
        "backend_ref": "openai/gpt-4o-mini"
      },
      {
        "id": "claude-3-5-sonnet-20241022",
        "provider": "anthropic",
        "backend_ref": "anthropic/claude-3-5-sonnet"
      }
    ]
  }
  ```
</ResponseExample>