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

# Gemini 兼容 OpenAI 模型列表

> 基于生产环境复核，使用 GET /v1beta/openai/models 获取 OpenAI 风格模型列表

> 更新日期：2026-06-06

# Gemini 兼容 OpenAI 模型列表

```
GET /v1beta/openai/models
```

这个端点是一个兼容桥：

* 认证方式可以走 Gemini 风格
* 返回结构仍是 OpenAI 风格模型列表

本文页只写入 `2026-03-23` 已在 Crazyrouter 生产环境复核过的行为。

## 什么时候用它

* 你的客户端习惯使用 `?key=`
* 你的中间层已经使用 `x-goog-api-key`
* 你想拿到 OpenAI 风格的 `list + data[]` 结构，而不是 Gemini 原生模型元数据

如果你是标准 OpenAI 客户端，优先用 [GET /v1/models](/chat/openai/models)。

## 认证

本轮已复核以下三种方式都可用：

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

```http theme={null}
x-goog-api-key: YOUR_API_KEY
```

```text theme={null}
GET /v1beta/openai/models?key=YOUR_API_KEY
```

## 请求示例

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.crazyrouter.com/v1beta/openai/models?key=YOUR_API_KEY"
  ```

  ```bash cURL with Header theme={null}
  curl https://api.crazyrouter.com/v1beta/openai/models \
    -H "x-goog-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

***

## 当前生产验证结论

在 `2026-03-23` 的生产复核中：

* `?key=` 请求返回 `200`
* `x-goog-api-key` 请求返回 `200`
* 顶层 `object` 为 `list`
* 顶层 `success` 为 `true`
* 当前返回模型数量为 `541`
* `data[]` 中元素的常见字段包括：
  * `id`
  * `object`
  * `created`
  * `owned_by`
  * `supported_endpoint_types`

***

## 响应示例

```json theme={null}
{
  "object": "list",
  "success": true,
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1700000000,
      "owned_by": "openai",
      "supported_endpoint_types": ["openai"]
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1700000000,
      "owned_by": "anthropic",
      "supported_endpoint_types": ["openai", "anthropic"]
    },
    {
      "id": "gemini-3.1-pro",
      "object": "model",
      "created": 1700000000,
      "owned_by": "google",
      "supported_endpoint_types": ["openai", "gemini"]
    }
  ]
}
```

## 字段说明

| 字段                         | 类型      | 说明              |
| -------------------------- | ------- | --------------- |
| `data[]`                   | array   | 当前 Token 可用模型列表 |
| `id`                       | string  | 模型标识符           |
| `owned_by`                 | string  | 模型来源或所属组织       |
| `supported_endpoint_types` | array   | 当前模型支持的接口风格     |
| `object`                   | string  | 固定为 `list`      |
| `success`                  | boolean | 请求是否成功          |

<Note>
  `supported_endpoint_types` 只表示当前模型支持的接口风格。当前 `openai` 对应 `POST /v1/chat/completions`，`anthropic` 对应 `POST /v1/messages`，`openai-response` 才对应 `POST /v1/responses`。Claude 当前公开支持的是 `openai` + `anthropic`，不支持 `openai-response`。
</Note>

<Note>
  这个端点不是“只返回 Gemini 模型”。它返回的是当前 Token 可见模型的 OpenAI 风格列表，只是入口和认证方式更适配 Gemini 风格客户端。
</Note>

相关页面：

* [模型官方定价方式](/reference/official-pricing-methods)
