Skip to main content

Codex 接入指南

本页说明如何把 Codex 配置为使用 Sowall API 的 OpenAI 兼容模型。API Key 只在本机 Codex 配置或环境变量中保存，不要写进公开文档或提交到仓库。

连接参数​

配置项值
API Base URLhttps://puhe-api.site/v1
API Key在 Sowall 控制台创建的个人 API Key
模型以 /v1/models 返回、并已授权给当前 Key 的模型为准

配置步骤​

  1. 在 Sowall 控制台创建 API Key，并确认 Key 有目标模型的访问权限。
  2. 在 Codex 的模型提供商设置中新增 OpenAI 兼容提供商。
  3. 填入 Base URL、API Key 和模型名称。
  4. 新建会话发送一条短消息，确认返回正常后再开始长任务。

切换模型​

同一会话跨模型系列切换时，建议先新建会话。旧会话可能携带上一个模型生成的 Responses item，中转链路不一定能验证或复用。

遇到 Item not found 或 encrypted content 错误时，先新建会话；如果仍失败，再检查模型是否出现在 /v1/models，以及 API Key 是否仍有效。