YooAi New API 新用户 Codex 使用指南

这份指南面向普通用户。你只需要访问：

https://api.fusionyoo.com/

按下面步骤创建自己的 API 密钥，然后登录后复制一条短时初始化命令。脚本会自动生成 Codex 配置文件，并把 API 密钥保存到你本机的用户环境里。

准备

1. 确认你已经有 YooAi New API 普通用户账户。

2. 确认本机已经安装 Codex，并且终端里能运行：

   codex --version
   

3. 如果管理员已经把 API 密钥发给你，可以跳过“创建 API 密钥”，登录后直接看“一键配置 Codex”。

创建 API 密钥

1. 打开 https://api.fusionyoo.com/ 并登录。

2. 进入控制台，打开 API Keys / API 密钥 / 令牌 页面。也可以直接尝试打开：

   https://api.fusionyoo.com/keys
   

3. 点击 Create API Key / 创建 API 密钥。

4. 名称建议填写 codex-设备名，例如 codex-macbook 或 codex-windows-home。

5. 额度、分组、过期时间和模型限制保持默认即可；如果管理员给了明确要求，按管理员要求填写。

6. 创建后复制完整 API 密钥。密钥通常以 sk- 开头，稍后需要粘贴到终端里。如果列表里复制不到完整密钥，就重新创建一个，或联系管理员处理。

不要把 API 密钥发到聊天、工单、截图或代码仓库里。

一键配置 Codex

登录 YooAi New API 后，本页面会为你的当前登录账户生成带短期授权 token 的一键配置命令。请直接复制页面显示的完整命令，不要手动拼接 /setup-codex-newapi.sh 或 /setup-codex-newapi.ps1 固定地址。

Windows 用户使用页面中的 PowerShell 命令。macOS/Linux 用户使用页面中的 Bash 命令。Windows 用户如果明确使用 WSL 或 Git Bash，也可以使用 Bash 命令；普通 Windows 用户优先使用 PowerShell 命令。

一键配置命令里的下载链接是一次性短期链接。每次点击“复制命令”都会自动生成新链接；命令已运行过或已过期时，再次点击复制即可，无需刷新页面。

运行脚本时怎么操作

1. 复制页面中与你系统对应的一键命令，粘贴到终端执行。

2. 看到下面提示时，输入 y 或 yes：

   Confirm the agent application on this device is Codex. Type y or yes to continue:
   

3. 看到下面提示时，粘贴你的 New API 密钥并回车。输入过程不会显示密钥：

   Paste the New API key. Input is hidden:
   

4. 看到下面提示后，关闭当前终端，重新打开一个终端：

   PASS: setup complete; open a new terminal and start Codex with: codex
   

5. 在新终端里运行：

   codex
   

也可以用下面命令测试：

codex exec "用一句话回复：配置成功"

脚本会生成什么

脚本会备份已有 Codex 配置，然后写入 YooAi New API 文本模型 provider。生图、改图请在文档页的生图改图板块中查看接入说明，安装YooAi MCP 与配套 Skill。

配置文件路径：

• Windows：%USERPROFILE%\.codex\config.toml
• macOS/Linux：~/.codex/config.toml

配置内容类似：

model = "<服务端当前默认模型>"
model_provider = "newapi"

[model_providers.newapi]
name = "YooAi"
base_url = "https://api.fusionyoo.com/v1"
env_key = "NEWAPI_API_KEY"
env_key_instructions = "Paste the New API key when running setup-codex-newapi.sh, then open a new terminal."

脚本不会把 API 密钥直接写进 config.toml。Codex 会通过 env_key = "NEWAPI_API_KEY" 从本机环境变量读取密钥。

Windows 上，脚本会保存当前用户级环境变量：

NEWAPI_API_KEY
OPENAI_API_KEY
OPENAI_BASE_URL

macOS/Linux 上，脚本会把密钥保存到：

~/.codex/newapi.env

内容形式是：

export NEWAPI_API_KEY='你的 New API 密钥'
export OPENAI_API_KEY='你的 New API 密钥'
export OPENAI_BASE_URL='https://api.fusionyoo.com/v1'

Codex custom provider 使用 base_url 配置 API 地址，使用 env_key 指定 API key 来自哪个环境变量。这里不需要单独配置 wire_api；省略时使用默认的 Responses 行为。

YooAi 生图与改图

请打开文档页的生图改图板块，按设备和 Agent 选择已开放的 MCP 与配套 Skill 完整包。 下载、安装和更新无需登录 NewApi；实际生图、改图仍使用自己的 API 密钥和额度。 首次安装可只安装程序，账户配置可稍后完成。密钥在本地隐藏输入中保存到系统安全存储。

新客户端支持的目标流程为生成图片、选择一张本地 PNG／JPEG 编辑、在同一会话中继续修改上一张成功结果。 每次另存新文件，不覆盖原图。无需更改 Codex 主模型，也无需图床或图片 MCP。 实际开放的平台、版本和验收状态以接入页及下载页为准；Windows 实机测试后补。

如果检测到旧图片配置冲突，请保留现有文件并按提示处理。文本模型一键脚本不会新增图片 MCP 或改写全局图片路由规则。

排障

• FAIL: missing command: codex：先安装 Codex，再重新运行初始化命令。
• 401 或鉴权失败：确认粘贴的是完整 API 密钥，通常以 sk- 开头。
• model is not available for this key：当前 API 密钥没有命令里指定的模型权限。确认账户有对应模型权限；如果不确定，联系管理员检查分组、令牌权限、模型权限和额度。
• gpt-image-2 调用失败：确认账户或管理员令牌有 gpt-image-2 模型权限、图片接口权限、可用分组路由和足够额度。
• 一键命令下载后显示 HTML 或报语法错误：联系管理员检查脚本发布地址。
• Windows 提示脚本执行被策略拦截：优先使用上面的在线 PowerShell 命令。
• 仍然提示缺少 NEWAPI_API_KEY：关闭终端并重新打开。macOS/Linux 也可以手动运行 source ~/.codex/newapi.env 后再运行 codex。
• 配置写错：脚本会生成 ~/.codex/config.toml.bak.<UTC时间> 备份，可用备份恢复。

安全提醒

• 每个用户只使用自己的 API 密钥。
• 每台设备建议单独创建一个 API 密钥，方便以后单独撤销。
• 密钥泄露或设备丢失时，立即到 New API 的 API 密钥页面删除该密钥，并重新创建新密钥。