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

# GET /v1/models — 可用模型列表

> 查询你的 API key 可用的 AI 模型列表。响应格式根据认证头自动适配。

`/v1/models` 端点返回你的 API key 有权使用的所有模型。Anyone 检查请求头并以匹配客户端的格式返回模型列表：默认为 OpenAI 格式，有 Claude 头时返回 Anthropic 格式，有 Google 头时返回 Gemini 格式。

***

## GET /v1/models

### 认证

使用与你期望的响应格式匹配的头传入 API key：

| 认证方式               | 需要的头                                                      | 响应格式           |
| ------------------ | --------------------------------------------------------- | -------------- |
| OpenAI（默认）         | `Authorization: Bearer YOUR_TOKEN`                        | OpenAI 模型列表    |
| Anthropic (Claude) | `x-api-key: YOUR_TOKEN` 和 `anthropic-version: 2023-06-01` | Anthropic 模型列表 |
| Gemini (Google)    | `x-goog-api-key: YOUR_TOKEN`                              | Gemini 模型列表    |

Gemini API key 也可通过 `?key=YOUR_TOKEN` 查询参数传入。

### 响应（OpenAI 格式）

使用 Bearer token 且无 Claude 或 Gemini 头时，响应遵循 OpenAI 模型列表格式：

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

<ResponseField name="data" type="object[]">
  模型对象数组。

  <Expandable title="模型对象属性">
    <ResponseField name="id" type="string">
      模型标识符。在请求的 `model` 字段中使用此值。
    </ResponseField>

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

    <ResponseField name="created" type="integer">
      此模型条目创建时间的 Unix 时间戳。
    </ResponseField>

    <ResponseField name="owned_by" type="string">
      模型所有者。例如 `"openai"` 或 `"system"`。
    </ResponseField>
  </Expandable>
</ResponseField>

***

## GET /v1/models/:model

通过 ID 查询特定模型的信息。

```
GET /v1/models/gpt-5.4
```

返回单个模型对象，格式与上述 `data` 数组中的条目相同。有 Claude 头时返回 Anthropic 模型格式。

***

## Gemini 格式端点

要获取 Gemini 格式的模型列表，可使用以下路径：

* `GET /v1/models`（带 `x-goog-api-key` 头）
* `GET /v1beta/models`（任意有效 API key）

***

### 示例

<CodeGroup>
  ```bash curl（OpenAI 格式） theme={null}
  curl https://api.anyone.ai/v1/models \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```bash curl（Claude 格式） theme={null}
  curl https://api.anyone.ai/v1/models \
    -H "x-api-key: YOUR_TOKEN" \
    -H "anthropic-version: 2023-06-01"
  ```

  ```bash curl（Gemini 格式） theme={null}
  curl "https://api.anyone.ai/v1/models?key=YOUR_TOKEN"
  ```

  ```python python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="YOUR_TOKEN",
      base_url="https://api.anyone.ai/v1",
  )

  models = client.models.list()
  for model in models.data:
      print(model.id)
  ```
</CodeGroup>

### 响应示例（OpenAI 格式）

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1715367049,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1715367049,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-3.1-pro-preview",
      "object": "model",
      "created": 1715367049,
      "owned_by": "google"
    }
  ]
}
```

<Tip>
  返回的模型反映你的 API key 被授权使用的模型。如果某个模型未出现，请让 Anyone 管理员在控制台的 API key 设置中授予访问权限。
</Tip>