# 获取模型列表

您可以通过 API 端点获取当前所有可用模型的列表。我们同时支持 OpenAI 和 Gemini 两种格式的 API（并非所有模型都支持 Gemini）。

## OpenAI 兼容模型列表

### 请求

#### 请求地址

```
GET https://api.modelverse.cn/v1/models
```

#### 请求示例

您可以直接使用 `curl` 命令来调用此接口
> ⚠️注意此接口只会返回文本生成的模型，若需要使用生图模型，请见【图片生成】

```bash
curl https://api.modelverse.cn/v1/models \
  -H "Content-Type: application/json" | jq .
```


### 响应

#### 响应示例

调用成功后，会返回一个 JSON 对象，其中包含一个模型对象列表。

```json
{
  "data": [
    {
      "created": 1762741377,
      "id": "deepseek-ai/DeepSeek-R1",
      "object": "model",
      "owned_by": "UCloud_UModelverse"
    },
    {
      "created": 1762741326,
      "id": "gpt-5",
      "object": "model",
      "owned_by": "UCloud_UModelverse"
    },
    ......
  ],
  "object": "list"
}
```

#### 响应体参数说明

| 参数       | 类型    | 描述                         |
| :--------- | :------ | :--------------------------- |
| `id`       | string  | 模型的唯一标识符。           |
| `object`   | string  | 对象类型，此处恒为 `model`。 |
| `created`  | integer | 模型创建时间的 Unix 时间戳。 |
| `owned_by` | string  | 模型所有者。                 |

## Gemini 兼容模型列表

### 请求

#### 请求地址

```
GET https://api.modelverse.cn/v1beta/models
```

#### 请求示例

您可以使用 `curl` 命令来调用此接口。
> ⚠️注意此接口只会返回支持gemini协议的模型

```bash
curl --location 'https://api.modelverse.cn/v1beta/models' \
  -H "Content-Type: application/json" 
```


### 响应

#### 响应示例

调用成功后，会返回一个 JSON 对象，其中包含一个模型对象列表。

```json
{
    "models": [
        {
            "name": "models/gemini-2.5-flash-image",
            "baseModelId": "gemini-2.5-flash-image",
            "version": "",
            "displayName": "gemini-2.5-flash-image",
            "description": "gemini-2.5-flash-image",
            "inputTokenLimit": 0,
            "outputTokenLimit": 0,
            "supportedActions": [
                "generateContent"
            ]
        },
        {
            "name": "models/gemini-2.5-pro",
            "baseModelId": "gemini-2.5-pro",
            "version": "",
            "displayName": "gemini-2.5-pro",
            "description": "gemini-2.5-pro",
            "inputTokenLimit": 0,
            "outputTokenLimit": 0,
            "supportedActions": [
                "generateContent"
            ]
        },
        {
            "name": "models/gemini-2.5-flash",
            "baseModelId": "gemini-2.5-flash",
            "version": "",
            "displayName": "gemini-2.5-flash",
            "description": "gemini-2.5-flash",
            "inputTokenLimit": 0,
            "outputTokenLimit": 0,
            "supportedActions": [
                "generateContent"
            ]
        }
    ]
}
```

#### 响应体参数说明

| 参数               | 类型    | 描述                    |
| :----------------- | :------ | :---------------------- |
| `name`             | string  | 模型的完整资源名称。    |
| `baseModelId`      | string  | 基础模型的 ID。         |
| `version`          | string  | 模型版本号。            |
| `displayName`      | string  | 模型的显示名称。        |
| `description`      | string  | 模型的描述信息。        |
| `inputTokenLimit`  | integer | 输入 Token 的最大限制。 |
| `outputTokenLimit` | integer | 输出 Token 的最大限制。 |
| `supportedActions` | array   | 模型支持的操作列表。    |