常见问题

Base URL 到底要不要带 /v1？

• Codex 与 Codex++ Provider 通常填 https://codexapi.asia。
• OpenAI Python/Node SDK 和多数 OpenAI Compatible 客户端通常填 https://codexapi.asia/v1。
• 最终请求路径只出现一次 /v1 即可。

为什么别人能看到模型，我看不到？

模型列表与 API Key 所属分组有关。请用你自己的 Key 请求 /v1/models，不要以别人的截图或软件内置列表为准。

同一个 API Key 能给多个软件用吗？

可以，但不推荐长期共用。按设备和用途拆分 Key 更容易限制额度、查看用量和单独吊销。

Fast / 1.5x 可以由客户端强制开启吗？

客户端可以请求 Fast 服务等级，但最终是否生效还取决于网关透传、模型能力和上游账号。配置项存在不代表当前请求一定按 Fast 执行。

流式和 WebSocket 哪个更好？

大多数聊天和编码客户端使用 SSE 流式即可。只有客户端明确支持 Responses WebSocket 时才选择 WebSocket。

429 后应该立即一直重试吗？

不要。读取 Retry-After，使用带随机抖动的指数退避，并设置最大重试次数。高频立即重试会进一步占用容量。

为什么生成图片后只有一大段文本？

那通常是 Base64 图片数据。需要支持图像结果的客户端，或自行解码 b64_json 保存为 PNG/JPEG。

文档和实际模型不一致怎么办？

以 /v1/models 和控制台当前分组为准。文档描述协议和接入方式，动态模型清单由服务端实时返回。