# 模型

从公开目录选择真实 model_code，理解模型类型、能力字段、价格和折扣字段。

## 从目录选择模型 [#从目录选择模型]

控制台模型库对应业务接口的公开模型路由：

```bash
curl -sS https://api.gfw.net/api/v1/models \
  -H "Accept: application/json"
```

测试环境目录也可用于核对示例模型：

```bash
curl -sS https://test.gfw.net/api/v1/models \
  -H "Accept: application/json"
```

响应中的 `data.models` 是模型数组。调用时使用每项的 `model_code`，例如 `deepseek-v4-pro`、`qwen3.7-max` 或 `gpt-5.4`。这些值是 GFW 的公开模型代码，不要把供应商的上游模型标识当作对外调用名称。

目录是动态数据：模型可能下架、限组或更换价格。部署配置不应只依赖文档中的静态清单。

## 模型类型与端点 [#模型类型与端点]

| `model_type` | 典型接口 | 计量字段的阅读方式 |
| --- | --- | --- |
| `llm` | `POST /v1/chat/completions`、`POST /v1/responses`、`POST /v1/messages` | 通常按输入和输出 Token 计量 |
| `image` | `POST /v1/images/generations` | 以模型实际价格规则为准，常见是按张或参数计量 |
| `video` | `POST /v1/videos` 或兼容的视频生成端点 | 以模型实际价格规则为准，可能按时长、分辨率或任务参数计量 |

对话接口不能替代图片或视频接口。服务端会根据模型类型拒绝错误端点，并返回建议的端点路径。

## 能力与限制字段 [#能力与限制字段]

模型对象可能包含以下字段：

| 字段 | 含义 |
| --- | --- |
| `context_window` | 上下文窗口大小 |
| `max_output_tokens` | 最大输出限制 |
| `supports_thinking` | 是否标记为支持推理/思考能力 |
| `supports_vision` | 是否标记为支持视觉输入 |
| `supports_function_call` | 是否标记为支持工具调用 |
| `supports_json_output` | 是否标记为支持 JSON 输出 |
| `supports_cache` | 是否标记为支持提示词缓存 |
| `rpm`、`tpm` | 目录提供的请求和 Token 速率参考值 |

能力字段是目录声明，不代表每种输入组合都能成功；请求仍需遵循对应协议和模型限制。

## 价格、折扣与阶梯规则 [#价格折扣与阶梯规则]

模型目录中的价格相关字段包括：

- `input_price`、`output_price`：模型基础输入、输出价格。
- `cache_price`：目录提供的缓存价格字段，可能为零或缺省。
- `pricing_rules`：可选的输入/输出阶梯规则；每个方向独立匹配条件和价格。
- `discount`：当前返回上下文中的用户组折扣字段；未登录访问可能显示标准组折扣，登录后以账户用户组为准。

对话模型的 `input_price`、`output_price`、`cache_price` 以及相应阶梯价格（字段存在时）单位都是 **元/百万 Token**；网关按 Token 数乘单价再除以 1,000,000 计算对应 Token 费用。它们不是每个 Token 的价格，也不等于人民币充值金额。图片、视频等媒体模型按模型规则以张、秒或生成次数等计量，不能把对话单价套用到媒体，也不要据此推导固定报价或汇率。模型价格、用户组折扣和阶梯规则都应以当次目录与账单为准。

例如目录中的 `glm-5.1` 返回了 `pricing_rules.input` 和 `pricing_rules.output`，而 `deepseek-v4-pro` 主要返回基础输入/输出价格。以下仅说明字段形状，数值和条件是**接口数据示意**：

```json
{
  "model_code": "example-model",
  "input_price": 1.0,
  "output_price": 2.0,
  "cache_price": 0.1,
  "discount": 0.85,
  "pricing_rules": {
    "input": [{"condition": "<=32K", "input_price": 1.0}],
    "output": [{"condition": "<=32K", "output_price": 2.0}]
  }
}
```

## 选择模型的步骤 [#选择模型的步骤]

1. 在[模型库](/models)按类型筛选，打开详情页确认能力和价格。
2. 记录 `model_code`，不要记录页面上的供应商内部标识。
3. 用同一个 API Key 在目标端点发一个最小请求。
4. 到[控制台用量](/console/usage)和[调用日志](/console/logs)核对返回状态、Token 与金额。
5. 上线前为 Key 设置合适的额度、速率或过期参数，并在应用中处理模型下架和余额不足。


**提示**

模型目录中出现的 `discount` 不是所有账户永久固定的折扣承诺。登录用户按实际用户组查询结果计价，最终以 元流水为准。


## 相关链接 [#相关链接]

- [开始使用](/docs/quickstart)
- [认证](/docs/authentication)
- [Responses API](/docs/responses)
- [工具调用](/docs/tool-calls)
- [错误处理](/docs/errors)