> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 保留 Codex 官方登录，使用第三方 GPT Image API 生图

> 保持 Codex 官方账号登录与文字模型配置，通过独立生图 Skill 接入 BetterToken GPT Image API。包含安装提示词、密钥配置、生图、参考图编辑和排错步骤。

推荐使用独立生图 Skill：Codex 继续通过原来的官方账号处理对话，Skill 使用 BetterToken API Key 调用图片接口，并将结果保存到本机。图片请求按 BetterToken 的实时价格计费。

本页使用社区项目 [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill)。它支持独立的 OpenAI-compatible 图片服务配置，不需要切换 Codex 主模型或覆盖登录文件。安装一次后，你可以直接用自然语言要求生图或改图。

## 准备好 Codex 和 API Key

1. 在本机 Codex App 或 Codex CLI 中完成官方账号登录，并打开一个项目。
2. <a href={"https://bettertoken.ai/register"}>创建 BetterToken API Key</a>，或使用已有的 Key。
3. 在<a href={"https://bettertoken.ai/pricing"}>模型广场</a>确认图片模型和当前价格。本页先用 `gpt-image-2` 完成首次调用。

Codex 需要能够运行本机脚本并访问 `bettertoken.ai`。该方案适用于本机 App 和 CLI；云端任务需要单独提供运行环境和凭据。

## 第一步：复制安装提示词给 Codex

将下面整段发给 Codex。这里没有真实 Key，你暂时只需复制提示词。

```text theme={null}
请为我的本机 Codex 安装并配置一个独立生图 Skill。

源仓库：https://github.com/Wangnov/gpt-image-2-skill
Skill 子目录：skills/gpt-image-2-skill
安装位置：用户目录 .agents/skills/gpt-image-2-skill；已有时检查并复用。

保持 Codex 官方登录、主模型、config.toml、auth.json 和 OPENAI_API_KEY 原样。
检查 Node.js；按仓库的 Node 包装器说明准备当前系统的运行时，不要要求我安装 Rust 开发环境。

使用当前 CODEX_HOME 下 gpt-image-2-skill/config.json 保存图片服务配置；
未设置 CODEX_HOME 时使用 ~/.codex/gpt-image-2-skill/config.json。
合并已有配置，保留其他条目。添加名为 bettertoken-image 的图片服务：
type = openai-compatible
api_base = https://bettertoken.ai/v1
model = gpt-image-2
credentials.api_key = {"source":"file","value":"YOUR_BETTERTOKEN_API_KEY"}
将图片 Skill 的 default_provider 设为 bettertoken-image。

生图和编辑时显式传入 --provider bettertoken-image。
不要使用 --provider codex、官方内置生图工具，或自动切换到其他图片服务。
Key 留作占位符，由我在本机文件中填写，不要让我把真实 Key 发进聊天。
现在仅做安装和配置检查，不发送付费生图请求。
完成后告诉我 Skill 和配置文件的绝对路径，以及实际 Base URL 和模型 ID；不要显示 Key。
```

如果 Node.js 缺失，按 Codex 的提示安装 Node.js LTS，再继续。正常情况下，Skill 的包装器会获取对应系统的已发布运行时。

## 第二步：在本机填写 Key

打开 Codex 返回的配置文件，在 `credentials.api_key.value` 中将占位符替换为 BetterToken API Key。默认文件位置：

| 系统 | 配置文件 |
| - | - |
| macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` |
| Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` |

如果设置了自定义 `CODEX_HOME`，以 Codex 返回的绝对路径为准。该文件是图片 Skill 的配置，与你的 Codex 官方登录文件分开。

新配置的结构如下；已有配置时只修改对应条目，保留其他内容：

```json theme={null}
{
  "version": 1,
  "default_provider": "bettertoken-image",
  "providers": {
    "bettertoken-image": {
      "type": "openai-compatible",
      "api_base": "https://bettertoken.ai/v1",
      "model": "gpt-image-2",
      "credentials": {
        "api_key": {
          "source": "file",
          "value": "YOUR_BETTERTOKEN_API_KEY"
        }
      }
    }
  }
}
```

将配置保存在本机私密目录，不要放入项目仓库或截图。这里的 `providers` 是社区工具的配置字段。

## 第三步：生成第一张图片

保存配置后，新建一个 Codex 对话，并发送：

```text theme={null}
使用 $gpt-image-2-skill，通过 --provider bettertoken-image 生成一张图片。
模型：gpt-image-2。生成 1 张 PNG，尺寸 1024x1024。
内容：白色摄影棚中的绿色陶瓷杯，柔和自然光，无文字。
保存到当前项目 output/images/mug.png，并展示生成图片。
不要使用官方内置生图工具或切换图片服务。
如果请求失败，请报告原因，不要更换模型或发起额外请求。
```

首次使用时，按 Codex 的提示允许本次脚本访问图片接口。生成可能需要几分钟，请等待当前请求完成。

确认以下结果：

* Codex 仍显示原来的官方账号。
* 本机存在 `output/images/mug.png`，并且能够打开。
* BetterToken 控制台的使用记录出现对应图片模型请求。

## 使用参考图编辑

将参考图放进项目，或提供它的本机路径，然后发送：

```text theme={null}
使用 $gpt-image-2-skill，通过 --provider bettertoken-image 编辑图片。
参考图：output/images/mug.png。
只把背景换成浅灰色，保留杯子的颜色、形状和构图。
使用 gpt-image-2，保存为 output/images/mug-edited.png。
不要覆盖原图，不要使用官方内置生图工具或切换图片服务。
```

Skill 的编辑流程调用图片编辑接口。上传参数和遮罩用法见[图生图文档](/zh/api-reference/images-edits)。切换图片模型时，在需求中写明模型广场里的完整 Model ID。

## 常见问题

| 现象 | 处理方式 |
| - | - |
| 找不到 Skill | 让 Codex 检查安装目录中的 `SKILL.md`，再新建对话；仍未加载时重启 Codex。 |
| 仍调用官方生图 | 明确写出 `$gpt-image-2-skill` 和 `--provider bettertoken-image`，让 Codex 核对图片配置中的地址与模型。 |
| `401` 或认证失败 | 检查图片配置里的 Key 是否完整、有效，是否仍是占位符。 |
| `404` 或模型不存在 | Base URL 使用 `https://bettertoken.ai/v1`，不要添加 `/responses` 或重复 `/v1`；核对完整 Model ID。 |
| 网络访问被拦截 | 按提示允许本次图片脚本的网络访问，并检查本机网络或代理。 |
| 超时、限流或余额不足 | 先查看 BetterToken 使用记录和余额。超时后先确认请求状态，再决定是否重试。 |

## 相关文档

* [图片生成 API](/zh/api-reference/images-generations)
* [Codex 官方登录与第三方文字 API](/zh/faq/codex/official-login-third-party-api)
* [OpenAI：Codex Skill 安装与发现](https://learn.chatgpt.com/docs/build-skills)
* [社区 Skill 配置与使用说明](https://github.com/Wangnov/gpt-image-2-skill)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.