创为 API

Codex 如何接入第三方 OpenAI 兼容 API（创为 API 配置）

发布: 2026-06-22 最后更新: 2026-07-20

如果你要让 Codex 通过创为 API 调用 OpenAI 兼容接口，核心只有两件事：把 Base URL 指向 https://api.wos.one/v1，并使用与该服务匹配的 API Key。Base URL 与 API Key 必须来自同一服务，否则最容易触发鉴权或模型错误。

一句话结论

Codex 接入第三方 OpenAI-compatible API 的基本原理，是让客户端把请求发送到新的 Base URL，并用该服务签发的 API Key 完成鉴权。对于创为 API，OpenAI-compatible Base URL 为 https://api.wos.one/v1。

这篇文章适合谁

  • 已经在使用 Codex、Cursor、脚本工具或 OpenAI 兼容 SDK 的开发者。
  • 需要统一多模型入口、统一账单或团队共享调用方式的小团队。
  • 想先验证第三方 API 接入链路，再决定是否长期使用的工作室或项目团队。

不适合谁

  • 需要直接使用某个模型厂商官方账号体系、官方后台或官方合同能力的团队。
  • 期望所有 Codex 功能都自动适配第三方 API 的用户。
  • 没有能力管理环境变量、密钥和客户端配置来源的使用者。

先分清三种东西

1. ChatGPT 订阅登录

这类登录通常用于网页产品或带账号授权的工具入口，不等同于 API 余额，也不等同于第三方 OpenAI-compatible API 的调用权限。

2. OpenAI 官方 API Key

这是 OpenAI 官方服务签发的密钥，应与 OpenAI 官方 Base URL 配套使用。

3. 第三方 OpenAI-compatible API Key

这是第三方服务签发的密钥，应与该第三方服务提供的 Base URL 配套使用。创为 API 属于这一类，因此应与 https://api.wos.one/v1 配套使用。

判断你的配置是否正确

满足下面两条，通常才算配置方向正确：

  1. OPENAI_BASE_URL 指向你准备使用的服务。
  2. OPENAI_API_KEY 来自同一服务。

常见错误不是“变量没写”，而是：

  • Base URL 已切到第三方，但 API Key 还是另一家服务的。
  • API Key 已切到第三方，但工具实际仍在读旧的 Base URL。
  • Shell 里改了变量，但 GUI、IDE、WSL 或新开的终端没有继承。

创为 API 的最小配置

必要变量

项目取值
OPENAI_BASE_URLhttps://api.wos.one/v1
OPENAI_API_KEYsk-your-api-key

关键说明

  • OpenAI-compatible Base URL 这里需要保留 /v1。
  • 示例中的 sk-your-api-key 只是示例值，不是真实密钥。
  • model 名称必须使用平台当前支持的真实模型名，最新可调模型以控制台为准。

不同系统的配置方式

Linux / macOS

export OPENAI_BASE_URL=https://api.wos.one/v1
export OPENAI_API_KEY=sk-your-api-key

如果你希望新终端自动生效，可以把变量写入 shell 配置文件，例如 ~/.zshrc 或 ~/.bashrc，再重新打开终端。

WSL

在 WSL 终端内设置：

export OPENAI_BASE_URL=https://api.wos.one/v1
export OPENAI_API_KEY=sk-your-api-key

注意不要默认认为 Windows 主机上的环境变量会自动传进当前 WSL 会话。WSL 与 Windows 的终端环境经常是两套上下文。

Windows PowerShell

当前会话可直接设置：

$env:OPENAI_BASE_URL = "https://api.wos.one/v1"
$env:OPENAI_API_KEY = "sk-your-api-key"

如果你改的是持久环境变量，记得重开终端，再验证工具读取到的是新值而不是旧缓存。

配置后的验证方法

优先做这三步：

  1. 在当前终端打印环境变量，确认值是否正确。
  2. 使用一个最简单的请求或工具命令验证是否能正常鉴权。
  3. 如有错误，先检查 Base URL、Key 来源、模型名三项，而不是先怀疑业务代码。

常见问题排查

1. OAuth 登录与 API Key 模式冲突

有些工具既支持账号登录，也支持 API Key。若工具优先读取登录态，你在环境变量里设置的第三方 API 可能不会真正生效。遇到这种情况，应先确认当前工具实际走的是哪种鉴权模式。

2. 环境变量残留

常见表现是：

  • 终端里看起来变量已经改了，但工具仍报旧服务错误。
  • 不同 shell、IDE、后台进程读取到不同变量值。

排查时重点检查：

  • 是否在多个 shell 配置文件重复写过变量。
  • 是否在系统环境变量和当前 shell 中存在冲突值。
  • 是否客户端或 IDE 需要重启后才读取新值。

3. Base URL 末尾 /v1 配置错误

对于创为 API 的 OpenAI-compatible 接口，应使用：

https://api.wos.one/v1

如果漏掉 /v1，常见后果是路径错误、404 或请求格式不匹配。

4. API Key 来源不匹配

第三方 Base URL 必须配第三方 Key。官方 Base URL 必须配官方 Key。两者混用时，最常见是 401、403 或模型权限错误。

5. 模型名错误

即使 Base URL 和 Key 都正确，模型名写错仍会返回模型不存在、无权限或请求失败。模型支持情况应以控制台可调列表为准。

6. 网络或 DNS 问题

如果出现连接超时、域名解析失败、偶发连接中断，应区分：

  • 工具本身配置错误
  • 本机网络或 DNS 问题
  • 上游服务暂时不可用

核心做法是先用最简单的请求复现，再逐层缩小问题范围。

风险和限制

  • 第三方 OpenAI-compatible API 不等于所有工具行为都与官方完全一致。
  • 客户端升级后，配置读取逻辑可能变化，升级后应重新验证。
  • 团队环境里若多个成员共享脚本或终端镜像，旧变量残留会放大排查成本。
  • 对于关键生产工作流，建议准备备用服务与重试策略，而不是只依赖单一调用入口。

下一步建议

常见问题

ChatGPT 订阅能直接当 API Key 用吗？

不能直接等同。订阅登录、官方 API Key 和第三方 API Key 是三套不同的接入方式。

只改 Base URL，不改 API Key 可以吗？

通常不行。Base URL 和 API Key 必须匹配同一服务。

这个配置能保证 Codex 的所有能力都可用吗？

不能这样承诺。不同工具版本、鉴权模式、模型调用链路和功能特性都可能带来差异，应以实际版本验证为准。

现在就把 AI 接入这件事，交给创为 API

一个 Base URL，接入 Claude、GPT、Gemini、图像、视频与 Coding / Agent 场景模型；注册即用，按量计费，部分模型线路低至 3 折起。

免费注册，立即开始 查看接入文档