> ## 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 で画像 API を呼び出し、結果をローカルに保存します。画像リクエストには BetterToken の現在の料金が適用されます。

このガイドではコミュニティの [Wangnov/gpt-image-2-skill](https://github.com/Wangnov/gpt-image-2-skill) を使います。OpenAI 互換画像 API の設定を独立して管理でき、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 向けです。クラウドタスクには別途実行環境と認証情報が必要です。

## 手順 1: 設定用プロンプトを Codex に送る

以下をすべてコピーします。実際の Key の代わりにプレースホルダーを使うため、チャットに 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 ラッパーで OS 用のリリース済みランタイムを用意してください。Rust 開発環境は要求しないでください。

現在の CODEX_HOME 配下の gpt-image-2-skill/config.json に画像設定を保存してください。
未設定の場合は ~/.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、Model ID を報告してください。Key は表示しないでください。
```

Node.js がない場合は、Codex の案内に従って Node.js LTS をインストールします。通常、ラッパーが OS 用のリリース済みランタイムをダウンロードします。

## 手順 2: Key をローカルで入力する

Codex が示した設定ファイルを開き、`credentials.api_key.value` のプレースホルダーを BetterToken API Key に置き換えます。

| OS | デフォルトの設定ファイル |
| - | - |
| macOS / Linux | `~/.codex/gpt-image-2-skill/config.json` |
| Windows | `%USERPROFILE%\.codex\gpt-image-2-skill\config.json` |

独自の `CODEX_HOME` を使う場合は、Codex が示す絶対パスを使います。画像設定は 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` はコミュニティツールの設定フィールドです。

## 手順 3: 最初の画像を生成する

設定を保存し、Codex で新しいチャットを開いて次を送ります。

```text theme={null}
$gpt-image-2-skill を --provider bettertoken-image で使って画像を生成してください。
モデル: gpt-image-2。1024x1024 の PNG を 1 枚生成してください。
被写体: 白いスタジオに置かれた緑色の陶器のマグカップ。柔らかな自然光。文字なし。
現在のプロジェクトの output/images/mug.png に保存し、画像を表示してください。
組み込みの公式画像ツールは使わず、画像サービスを切り替えないでください。
失敗した場合は原因を報告し、モデルを変更したり別のリクエストを送信したりしないでください。
```

Codex が確認を求めたら、この画像スクリプトの API 通信を許可します。生成には数分かかる場合があります。現在のリクエストが終了するまで待ちます。

元の 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 は画像編集エンドポイントを使います。アップロードとマスクは[画像編集](/ja/api-reference/images-edits)を参照してください。画像モデルを変更する場合は、モデル広場の完全な Model ID を指定します。

## トラブルシューティング

| 症状 | 対処 |
| - | - |
| Skill が見つからない | インストール済みの `SKILL.md` を Codex に確認させ、新しいチャットを開きます。解決しなければ Codex を再起動します。 |
| 公式画像ツールが使われる | `$gpt-image-2-skill` と `--provider bettertoken-image` を明示し、画像設定の URL とモデルを確認します。 |
| `401` または認証エラー | 画像設定に完全で有効な Key が入り、プレースホルダーが残っていないか確認します。 |
| `404` またはモデルが見つからない | `https://bettertoken.ai/v1` を使い、`/responses` や重複する `/v1` を付けません。正確な Model ID を確認します。 |
| ネットワークが遮断される | この画像スクリプトの通信を許可し、ローカルネットワークやプロキシを確認します。 |
| タイムアウト、レート制限、残高不足 | BetterToken の利用ログと残高を確認します。タイムアウト後はリクエストの状態を確認してから再試行します。 |

## 関連ドキュメント

* [画像生成 API](/ja/api-reference/images-generations)
* [公式 Codex ログインとサードパーティのテキスト API](/ja/faq/codex/official-login-third-party-api)
* [OpenAI: ローカル 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.