Codex 接入指南
本页说明如何把 Codex 配置为使用 Sowall API 的 OpenAI 兼容模型。API Key 只在本机 Codex 配置或环境变量中保存，不要写进公开文档或提交到仓库。
连接参数
| 配置项 | 值 |
|---|---|
| API Base URL | https://puhe-api.site/v1 |
| API Key | 在 Sowall 控制台创建的个人 API Key |
| 模型 | 以 /v1/models 返回、并已授权给当前 Key 的模型为准 |
配置步骤
- 在 Sowall 控制台创建 API Key，并确认 Key 有目标模型的访问权限。
- 在 Codex 的模型提供商设置中新增 OpenAI 兼容提供商。
- 填入 Base URL、API Key 和模型名称。
- 新建会话发送一条短消息，确认返回正常后再开始长任务。
切换模型
同一会话跨模型系列切换时，建议先新建会话。旧会话可能携带上一个模型生成的 Responses item，中转链路不一定能验证或复用。
遇到 Item not found 或 encrypted content 错误时，先新建会话；如果仍失败，再检查模型是否出现在 /v1/models，以及 API Key 是否仍有效。