> ## 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.

# GET /v1/models：列出 Router 入口与 provider 模型

> 以 OpenAI 兼容格式返回可用模型。列出咏唱引擎 ROUTER 中配置的入口与共享 provider 模型。

从咏唱引擎 ROUTER 获取可用模型列表。此接口以标准的 OpenAI `{object: 'list', data: [...]}` 信封返回配置的入口（用于路由的虚拟模型名称）与底层 provider 模型。

## 接口

**GET** `/v1/models`

数据面接口。使用 `Authorization: Bearer <router-key>` 认证。

## 响应

<ResponseField name="object" type="string">
  恒为 `"list"`。
</ResponseField>

<ResponseField name="data" type="array">
  模型对象数组。

  <Expandable title="模型对象字段">
    <ResponseField name="id" type="string">
      模型或入口名称。
    </ResponseField>

    <ResponseField name="object" type="string">
      恒为 `"model"`。
    </ResponseField>

    <ResponseField name="owned_by" type="string">
      入口为 `"aria-router"`，provider 模型为 `"provider"`。
    </ResponseField>
  </Expandable>
</ResponseField>

## 示例

```bash theme={null}
curl -H 'Authorization: Bearer $ARIA_ROUTER_KEY' \
  http://<router-host>:8080/v1/models
```

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "ariacompute/semantic-auto",
      "object": "model",
      "owned_by": "aria-router"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "owned_by": "provider"
    }
  ]
}
```