模型与分组怎么选

选择顺序不是“先找模型”，而是：

客户端与协议 -> 可用分组 -> 实时模型列表 -> 模型参数

1. 先确认客户端协议

客户端或用途	需要的接口	配置提示
Codex CLI / Codex 扩展	OpenAI Responses	Provider 的 wire_api 使用 responses
Claude Code	Anthropic Messages	Base URL 使用 https://freedomz.cn
OpenCode	OpenAI Compatible	使用 @ai-sdk/openai-compatible Provider
通用聊天客户端或 SDK	Chat Completions	Base URL 使用 https://freedomz.cn/v1
图片生成	对应图片接口和模型	先确认客户端支持图片请求结构

不能因为模型名称相似，就把 OpenAI、Anthropic 或图片协议配置互换。

2. 再选择分组

创建 Key 时，分组决定该密钥可以调用的模型、协议和计费范围。请选择控制台当前 实际提供的分组：

• 使用 Codex 时，选择明确支持 Responses 和目标模型的分组。
• 使用 Claude Code 时，选择支持 Anthropic Messages 的分组。
• 使用普通 OpenAI SDK 时，选择支持 OpenAI 兼容接口的分组。
• 不确定时先为测试创建独立 Key，不要修改生产 Key 反复试错。

分组名称和可用状态可能调整，文档不写死具体名称。

3. 查询实时模型

模型名称以控制台和以下接口返回为准：

curl https://freedomz.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

文档不维护固定模型清单，避免在上游下线、重命名或调整能力后产生误导。

从 data[].id 原样复制模型名称，大小写、连字符和版本后缀都不要自行修改。

4. 检查模型参数

不同模型支持的推理强度、工具、图片、上下文和输出长度不同：

• Codex 的 model_reasoning_effort = "xhigh" 只应在目标模型明确支持时使用。
• 不支持的实验参数应删除后再做最小请求。
• 工具调用、图片和长上下文应在普通文本请求成功后逐项增加。
• 客户端的显示名称不一定等于 API 请求中的真实模型 ID。

模型别名与路由

部分模型名称可能是路由别名，不代表固定的上游账号、地区、硬件、供应商版本或 发布日期。为了稳定性和风险控制，同一别名的底层路由可能调整。

常见误区

误区	正确做法
在网上找到模型名后直接填写	只使用当前 Key 的 /v1/models 返回值
换分组后仍沿用旧模型列表	重新查询实时模型
Claude Code 直接填 OpenAI /v1 地址	使用 Claude Code 专题中的 Anthropic 网关配置
Codex 只设置 OPENAI_BASE_URL	使用当前 Codex 的 model_providers 配置
model not found 后循环重试	停止重试，检查分组和模型 ID

兼容性边界

OpenAI 兼容表示主要请求结构和认证方式兼容，并不保证所有厂商专属参数、 实验字段、响应头或错误文本完全一致。遇到不支持参数时：

1. 保留最小请求字段重新测试。
2. 删除厂商专属或实验参数。
3. 查询实时模型列表。
4. 将脱敏后的请求结构和错误信息提交给支持。

怎么确认选择正确

1. /v1/models 能看到目标模型。
2. 最小请求返回 HTTP 200。
3. 使用记录 出现对应模型和 Key。
4. 费用与控制台显示的计费规则一致。

输出责任

模型输出可能不准确、过时或不适合特定场景。医疗、法律、财务、安全决策和其他 高影响用途必须由具备资格的人员复核，不得仅依赖模型输出自动作出决定。