# 获取可用模型

使用 `GET /models` 获取当前凭据可用于 API 调用的模型 ID。这是面向应用代码的查询：从响应中的 `data[].id` 选择模型 ID，再填入后续请求的 `model` 字段。

如需在控制台中搜索、筛选和比较模型，请参阅 Genesis 指南中的[模型广场](../../../../guides/genesis/models.md)。模型广场用于人工比较；`GET /models` 用于确认当前凭据实际可以调用哪些模型。

## 通过 API 查询

```bash
curl "$GENESIS_BASE_URL/models" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"
```

将 `$GENESIS_ACCESS_TOKEN` 替换为个人访问令牌，或已授予 Genesis 权限的服务账号 API Key。`GET /models` 请求必须携带 Bearer 凭据；创建凭据和认证失败排查请参阅[身份认证](authentication.md)。

请求不需要请求体。请求成功后，从 `data[].id` 读取模型 ID。模型广场中能看到的模型不一定都出现在当前结果中；应用只应使用当前结果返回的模型 ID。

## 响应示例

```json
{
  "object": "list",
  "data": [
    {
      "id": "<model-id>"
    }
  ]
}
```

| 字段 | 类型 | 返回条件 | 说明 |
| --- | --- | --- | --- |
| `object` | string | 成功响应返回 | 列表响应的对象类型。 |
| `data` | array | 成功响应返回 | 当前凭证可访问的模型列表。 |
| `data[].id` | string | 每个模型项返回 | 模型 ID。将此值作为后续请求的 `model` 字段。 |
| `data[].type` | string | 当前响应包含时返回 | 模型类型。可用于辅助筛选。 |
| `data[].capabilities` | array | 当前响应包含时返回 | 模型支持能力。可用于确认特定调用形态或输入能力。 |

`type`、`capabilities` 以及其他模型元数据可能随模型和部署变化。应用应以 `id` 作为调用所需的最小字段，并在使用可选字段前兼容缺失或新增字段。

## 使用查询结果

1. 根据[选择模型与能力](choose-model-capabilities.md)确定所需的任务类型和能力。
2. 调用 `GET /models`，从 `data[].id` 选择目标模型。
3. 将模型 ID 填入目标接口请求的 `model` 字段。
4. 先发送最小请求，确认目标模型支持所需的输入和可选参数。

如果目标模型未出现在响应中，请先在[模型广场](../../../../guides/genesis/models.md)检查模型状态；使用服务账号时，再检查其 Genesis 产品权限和目标模型范围。不要仅按名称替换为相近模型；不同模型可能支持不同的输入、参数和响应行为。

## 下一步

- [文本对话](../openai-compatible/chat-completions/text-chat.md)
- [选择模型与能力](choose-model-capabilities.md)