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

# Model 数据结构

> 模型列表接口的复用响应结构。

## Model 对象

`GET /api/v1/cloud/models` 返回该结构。

| 字段                          | 类型         | 说明                                                                    |
| --------------------------- | ---------- | --------------------------------------------------------------------- |
| `id`                        | string     | 模型标识，用作 `agent.model`                                                 |
| `type`                      | string     | 固定值 `"model"`                                                         |
| `display_name`              | string     | 用于展示和选择的模型名称                                                          |
| `source`                    | string     | 模型来源。可选值：`system`、`user`                                              |
| `is_enabled`                | boolean    | 模型是否启用。列表接口会过滤上游禁用的模型                                                 |
| `is_new`                    | boolean    | 模型是否标记为新模型                                                            |
| `price_factor`              | number     | 可选的相对价格系数                                                             |
| `efforts`                   | string 数组  | 可选的 reasoning effort 值。可选值：`none`、`low`、`medium`、`high`、`xhigh`、`max` |
| `default_effort`            | string     | 上游模型目录提供时返回的默认 effort                                                 |
| `max_input_tokens`          | integer    | 模型支持的最大输入上下文（token 数）                                                 |
| `default_context_window`    | integer    | 可选，Agent 未设置 `model.context_window` 时使用的默认上下文窗口（token 数）              |
| `available_context_windows` | integer 数组 | 可选，Agent `model.context_window` 可选的上下文窗口档位（token 数）                   |

## 模型列表响应

| 字段         | 类型                       | 说明          |
| ---------- | ------------------------ | ----------- |
| `data`     | [Model 对象](#model-对象) 数组 | 当前场景可用模型    |
| `has_more` | boolean                  | 固定为 `false` |

## 相关

<CardGroup cols={2}>
  <Card title="定义 Agent" icon="user-gear" href="/zh/cloud-agents/define-agent">
    创建可复用、可版本化的 Agent 配置。
  </Card>
</CardGroup>