|

Codex CLI 新版默认选 GPT‑6.2 Sol,接 API易后怎么确认实际用的是哪个模型?

Codex CLI 新版默认选 GPT‑6.2 Sol,接 API易后怎么确认实际用的是哪个模型?

摘要:Codex CLI 0.171.0 把 GPT‑6.2 Sol 设为默认目录选项后,本文说明如何用四种证据确认接入 API易 的 Codex 实际请求了哪个模型。

结论先行:Codex CLI 用的是不是 GPT‑6.2 Sol,要分四层看

结论是:接入 API易 apiyi.com 后,判断 Codex CLI 实际用了哪个模型,不能只看一个地方。按这个顺序核对:先用 /status 看会话选择,再看网关回包里的 model,然后到调用日志里看计费名 model_name,最后,上游渠道只能靠链路记录确认。前三层由你自己就能核对,第四层需要带着请求 ID 去查链路。

有两个条件会改变答案。第一,0.171.0 把 GPT‑6.2 Sol 设为默认目录选项,但它只在没有显式配置时生效,不会覆盖你已写好的 model 配置,既有会话则以实际显示为准。第二,Codex 里 model 和 model_provider 是两项独立设置,--model gpt-6.2-sol 只改模型,不会把请求切到 API易。所以「界面显示 Sol」和「请求经 API易 发给了 Sol」是两回事。

知识地图与索引:Codex CLI 模型核对的四层证据

下表既是知识地图,也是阅读索引。四层证据从客户端一直排到上游,越往后越接近事实,但获取成本也越高。

检查顺序 证据 在哪看 能证明什么 不能证明什么 正文
① 会话选择 Codex 里的 /status、/debug-config 客户端打算用哪个模型、发往哪个 provider 请求确实到达了网关 1
② 网关回包 Responses 顶层 model、SSE 完成事件 response.model、X-Shellapi-Request-Id 网关受理了请求并返回了模型标识 这笔费用记在哪个模型下 2
③ 计费模型 调用日志里的 model_name 这笔调用按哪个模型计费 上游真实走的是哪条渠道 3
④ 上游路由 链路记录或上游凭据 请求最终路由到哪个上游 —— 4

之所以按这个顺序:① 成本最低,大部分「默认值没生效」的问题在这一步就能发现;② 给出请求 ID,作为 ③ 和 ④ 的检索钥匙;③ 回答「钱花在哪个模型上」,这是多数人真正关心的问题;④ 只在前三层对不上、或有合规要求时才需要。读完后,你能拿到一组互相印证的证据:会话设置、回包模型、计费记录,再加一个请求 ID。

codex-cli-gpt-6-2-sol-apiyi-model-verification-image-0

To Know:核对 Codex CLI 模型前要懂的术语

术语 简明解释
model_provider Codex 配置中的服务提供方,决定请求发到哪个 base_url,与 model 相互独立
wire_api provider 使用的接口协议,接 API易 时设为 responses,即 Responses API
Responses API OpenAI 的响应接口,非流式回包顶层带 model 字段
SSE 完成事件 流式输出结束时下发的事件,其中的 response.model 记录了模型标识
model_name API易 调用日志中的计费模型名,表示这笔调用按哪个模型计费
令牌分组 / 模型白名单 决定某个 API Key 能调用哪些模型,公开模型总表里有,不代表你的令牌一定能用
X-Shellapi-Request-Id API易 响应头中的追踪 ID,用来定位单笔请求的链路记录

1. 会话选择:Codex CLI 当前选了哪个模型

1.1 确认 Codex CLI 版本与默认值的作用范围

先运行 codex --version。OpenAI 的 0.171.0 发布说明记录了这次目录更新;如果你用的是旧版本或自定义 provider,仍可直接按下面的步骤核对会话与调用。

确认版本后,要记住默认值的边界:配置文件或命令行里写了 model,就以显式配置为准;检查续用的旧会话时直接读 /status;想排除会话和既有配置的影响,可新开会话对照。

1.2 用 /status 和 /debug-config 查看 GPT‑6.2 Sol 是否生效

在交互会话里输入 /status,查看当前会话的模型和 provider。如果显示的模型不是预期的那个,再用 /debug-config 查看每项配置的来源,看它来自配置文件、profile,还是命令行参数。要临时切换模型,用 /model。

这一步只能说明客户端的「意图」:它准备用哪个模型、发给哪个 provider。请求有没有真正发出、网关是否受理,要靠后面几层证据确认。

1.3 分开核对 model 与 model_provider

接入 API易 时,provider 需要单独声明。下面是一份最小配置示意,字段以官方文档为准,Key 通过环境变量读取,不要写进文件:

model = "gpt-6.2-sol"
model_provider = "apiyi"

[model_providers.apiyi]
name = "APIYI"
base_url = "https://api.apiyi.com/v1"
env_key = "APIYI_API_KEY"
wire_api = "responses"
export APIYI_API_KEY="sk-xxxxxxxx"   # 占位符,替换为你自己的令牌

重点检查 /status 里的 provider 是不是 apiyi。命令行传入 --model 只会替换模型,不会改变 provider。如果 provider 仍然是默认值,那么无论模型名写得多对,请求都不会经过 API易。

2. 网关回包:Codex CLI 请求到达后返回了什么

2.1 读取 Responses 顶层 model 与 SSE 的 response.model

非流式调用 Responses API 时,回包顶层有 model 字段。Codex 通常使用流式输出,这时要看 SSE 完成事件里的 response.model。这个值是网关返回给客户端的模型标识,比 /status 更接近实际请求。

不过,回包里的字符串只是网关的返回值,用来判断上游渠道并不充分,这一点在第 4 部分展开。

2.2 最小验证命令:用 curl 检查接口与模型可用性

下面这条命令向 Responses 接口发送一个极短请求,同时打印响应头和响应体:

curl -sS -D - https://api.apiyi.com/v1/responses \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.2-sol","input":"只回复 OK"}'

在输出里找两样东西:响应头中的 X-Shellapi-Request-Id,以及响应体顶层的 model。如果返回模型不可用或无权限,先查公开模型总表 API易 公开模型总表,确认 gpt-6.2-sol 已经上架,再查令牌分组和白名单(令牌模型白名单说明)。总表里有,不代表你的令牌能调用。

要注意这条命令的边界:curl 发出的是一笔独立请求,只能证明「这个令牌、这个接口、这个模型 ID 走得通」,不能证明 Codex 刚才那一笔用了什么。Codex 那一笔要靠第 3 部分的日志来核对。

2.3 记下 X-Shellapi-Request-Id 作为检索钥匙

每次核对都把请求 ID 记下来。它能把回包、日志和链路记录对应到同一笔调用上,后续联系支持排查时,也是最直接的定位依据。具体用法见 请求 ID 排查说明。

codex-cli-gpt-6-2-sol-apiyi-model-verification-image-1

3. 计费模型:Codex CLI 这一笔按哪个模型计费

3.1 用同一令牌和窄时间窗查询调用日志

在 Codex 里发一句「只回复 OK」,记下发送时间,然后打开 API易 调用日志,用 Codex 所用的同一个令牌,把时间范围缩到这一两分钟。先不要按模型筛选:如果你输入的模型名和计费名写法不一致,按模型筛选反而会把真正的那条记录过滤掉。

时间窗里没有消费记录时,先校对时区和令牌,再检查请求是否拿到响应;若报错,留存原始错误和可见的请求 ID。最后回到 1.3 检查 provider 和环境变量。

3.2 读取 model_name 字段

找到记录后,看 model_name 字段,它是这笔调用的计费模型名,决定费用按哪个模型计算。把它和 /status 显示的模型、回包里的 model 放在一起对比,三者一致时,前三层证据就闭合了。

如果还想看每一轮对话消耗了多少 token,可以参考 用 API易 调用日志查看 Codex 每轮 Token 消耗,里面讲的就是用日志按轮次拆解 Codex 用量。

4. 上游路由:GPT‑6.2 Sol 最终走了哪条渠道

4.1 上游渠道只能由链路记录确认

前三层回答的是「客户端选了什么、网关返回了什么、按什么计费」。请求最终路由到哪个上游渠道,只能靠链路记录或上游凭据确认。下面三种常见做法都不能作为依据:

  • 模型自报:问模型「你是谁」,回答受训练数据和系统提示影响,不代表实际路由。
  • 账单单价:不同渠道可能价格相同,同一渠道也可能调价,单价推不出渠道。
  • 回包字符串:model 字段是网关返回的标识,能和计费对应,但不能单独证明上游。

确实需要确认上游时,带上 X-Shellapi-Request-Id 和调用时间,通过 API易 的支持渠道查询链路记录。

4.2 Codex CLI 模型对不上时的排查表

现象 可能原因 排查动作
/status 显示的不是 gpt-6.2-sol 有显式 model 配置或 profile 覆盖了默认值;或者是升级前开启的旧会话 用 /debug-config 查看来源,用 /model 切换,或新开会话
模型正确,但 provider 不是 apiyi --model 只改模型,没改 provider 检查 model_provider 和 [model_providers.apiyi] 配置
日志时间窗内查不到记录 令牌或时区不一致,或请求未形成消费记录 核对令牌、时区与响应,必要时再检查 provider
返回模型不可用或无权限 令牌分组或白名单不包含该模型 先查公开模型总表,再查令牌白名单设置
按模型筛选查不到,不筛选能查到 输入的模型名和计费名写法不同 以 model_name 为准,后续按计费名筛选
回包 model 与 model_name 不一致 返回标识和计费名的命名口径不同 以 model_name 核对费用,带请求 ID 咨询支持
curl 正常,Codex 异常 curl 只验证了接口,Codex 配置有问题 回到第 1 部分逐项检查会话选择

4.3 验收条件:四项证据怎样才算闭合

下面四项可核对这笔请求经 API易 受理、返回的模型标识以及计费模型:/status 显示模型为 gpt-6.2-sol、provider 为 apiyi;回包或 SSE 完成事件里的模型标识与之对应;在同一令牌、同一时间窗的日志中找到记录,且 model_name 符合预期;手里保存了这笔调用的 X-Shellapi-Request-Id。要确认具体上游渠道或模型快照,还需要相应的路由记录或上游凭据。

本文未做带真实密钥的线上实测。参阅 OpenAI Codex 更新日志、Codex 配置原则、API易 Responses 接入文档和 API易 日志查询。

类似文章