模型
从公开目录选择真实 model_code，理解模型类型、能力字段、价格和折扣字段。
从目录选择模型
控制台模型库对应业务接口的公开模型路由：
curl -sS https://api.gfw.net/api/v1/models \
-H "Accept: application/json"测试环境目录也可用于核对示例模型：
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 主要返回基础输入/输出价格。以下仅说明字段形状，数值和条件是接口数据示意：
{
"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}]
}
}选择模型的步骤
- 在模型库按类型筛选，打开详情页确认能力和价格。
- 记录
model_code，不要记录页面上的供应商内部标识。 - 用同一个 API Key 在目标端点发一个最小请求。
- 到控制台用量和调用日志核对返回状态、Token 与金额。
- 上线前为 Key 设置合适的额度、速率或过期参数，并在应用中处理模型下架和余额不足。
模型目录中出现的 discount 不是所有账户永久固定的折扣承诺。登录用户按实际用户组查询结果计价，最终以 元流水为准。