OpenAI 模型与分组

Codex Relay 的模型列表不是固定写死的。API Key 所属分组、当前账号池和管理员公开策略共同决定你能看到和调用哪些模型。

获取真实模型列表

curl https://codexapi.asia/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

请复制返回对象中的 id。客户端显示的昵称、历史配置或第三方软件内置列表都不能代替这个结果。

分组决定什么

项目	影响
接口能力	Responses、Chat Completions、Embeddings 或 Images
可见模型	/v1/models 返回哪些模型 ID
调度池	请求可以使用哪些上游账号
计费规则	模型倍率、订阅或余额扣费方式
并发与限流	同时请求数、RPM 和其他窗口限制

模型名与别名

模型名区分字符，建议原样复制。管理员可以把公开模型名映射到上游模型，但用户端只应使用分组公开的名称。

模型不存在时

先重新请求 /v1/models。如果模型不在列表中，修改本地名称没有意义，需要更换分组或由管理员公开对应模型。

模型与端点匹配

类型	常用端点	说明
OpenAI Responses	POST /v1/responses	Codex 和新式 OpenAI 客户端优先使用
OpenAI Chat	POST /v1/chat/completions	通用聊天客户端兼容性较好
OpenAI Embeddings	POST /v1/embeddings	向量化与检索工作流
OpenAI Images	POST /v1/images/generations	仅适用于公开图像模型的分组

容量和自动调度

同一公开模型背后可以有多个上游账号。调度器会在允许的池中选择可用账号；当所有兼容账号都繁忙、限流或不可用时，可能返回 429、503 或 Selected model is at capacity。

客户端应保留流式连接、尊重 Retry-After，并对可重试错误使用带抖动的指数退避。不要在极短时间内无限循环重试。