ChatGPT サブスクリプション → 画像生成 API ビジュアル早わかり：chatgpt-imagegen を一枚で理解

郭立（Leo） · 2026年5月26日 · 更新 2026年10月9日 · 5分で読めます

visual guide · 1ページで理解

ChatGPT サブスクリプションをあなたの画像生成 API として使う

すでに ChatGPT Plus / Pro / Team の月額料金を払っているけれど、コマンドラインや AI agent の中で画像生成が必要ですか？OPENAI_API_KEY に別途チャージする必要はありません——300 行の Python CLI がサブスクリプション枠をそのまま再利用します。

$ chatgpt-imagegen "a watercolor cat sitting on a windowsill" -o cat.png -> saved: cat.png (812,344 bytes) size=1024x1024 quality=medium # 1行コマンド、API key なし、プロキシなし、daemon なし

OpenAI の画像生成には実は2つのルートがある

ほとんどの開発者が知っているのは左側のルートだけです。右側のルートはCodex CLI ユーザー以外にはほぼ見えません——しかし、あなたが毎月払っているサブスクリプション料金には実はこれも含まれています。

ルート A

公式 API

画像ごとの課金 · OPENAI_API_KEY が必要

POST /v1/images/generations

ルート B · 隠れた経路
ChatGPT サブスクリプション月額固定 · ~/.codex/auth.json で認証
POST chatgpt.com/backend-api/codex/responses

ルート B は、OpenAI Codex CLI に内蔵された image_gen ツールが使うエンドポイントです。chatgpt-imagegen がやっていることは、このルートを取り出して CLI の外殻を付けることです。スクリプト化でき、AI agent から直接呼び出せます。

30秒でセットアップ

# 前提：Codex CLI をインストールし、ChatGPT サブスクリプションアカウントで一度ログインする $ npm i -g @openai/codex $ codex login # 方法 A：AI agent skill としてインストール（Claude Code / Cursor / Codex Agent） $ npx skills add leeguooooo/chatgpt-imagegen -g # 方法 B：独立 CLI $ git clone https://github.com/leeguooooo/chatgpt-imagegen $ sudo install chatgpt-imagegen/chatgpt-imagegen /usr/local/bin/

内部プロトコル：1回の呼び出しで何が起きるか

Codex のログイン状態を読む ~/.codex/auth.json · ~/.codex/version.json

Responses API リクエストを構築 tools: [{type: "image_generation"}]

内部エンドポイントへ POST chatgpt.com/backend-api/codex/responses

SSE ストリームを消費 image_generation_call.in_progress → generating → output_item.done

デコードして保存 item.result (base64 PNG) → cat.png

token 期限切れは自動更新 auth.openai.com/oauth/token (refresh_token) → auth.json に書き戻し

機能マトリクス：何ができて、何ができないか

機能	サブスクリプション経路	説明
`--size`	✅ 有効	実測では安定：`1024x1024`、`1024x1536`、`1536x1024`。より大きなサイズはそのまま渡され、成功するかどうかはサブスクリプションのプラン次第
`--format`	✅ 有効	png / jpeg / webp はいずれも可能
画質 `quality`	⚠️ サーバー側が決定	サブスクリプション経路では制御可能な quality フィールドが公開されておらず、`high` をリクエストしてもこっそりダウングレードされます——そのため CLI にはこのフラグをそもそも追加していません
透明背景 `background: transparent`	❌ 非対応	公式 API + `gpt-image-1.5` を使う必要があります
画像編集 `/v1/images/edits`	❌ 未実装	必要であればリポジトリで issue を立ててください
速度	15–40 s / 枚	全経路 SSE ストリーミング

並行実測

4×

並行リクエストはすべて 200 で返却

~27s

総所要時間 ≈ 最も遅い1枚

429 / シリアル化

≤10/min

推奨される継続レート上限

実測では Plus アカウントで chatgpt-imagegen を同時に4つ実行しても、サーバー側のレート制限もシリアル化もありませんでした。ただしサブスクリプション枠はChatGPT の Web 版や Codex CLI と共有されます——長時間 >10 枚/分にしないでください。日次レート制限にぶつかります。

このツールを使うべきでない場面

以下のいずれかに当てはまる場合は、直接公式 API を使ってください：

厳密な quality=high または透明背景が必要——サブスクリプション経路では提供できません
エンドユーザー向けの本番サービスを作っている——これは OpenAI サービス利用規約に違反するだけでなく、自分の ChatGPT 利用枠も使い切ってしまいます
呼び出しごとの正確なコスト配賦をしたい——サブスクリプションは月額制なので、各呼び出しに按分できません
安定した >10 枚/分のスループットが必要——サブスクリプションのレート制限はより厳しめです

二択：ローカル CLI か HTTP ゲートウェイか？

このリポジトリ

chatgpt-imagegen

ノートPCでたまに画像生成したり、AI agent の skill として使ったり、shell スクリプトから呼び出したりする用途向け。Python ファイル 1 つで、ネットワークサービスはありません。

姉妹プロジェクト

agent-cli-to-api

同じサブスクリプション経路を OpenAI 互換の /v1/chat/completions HTTP サービスとしてラップし、チーム / 複数クライアント / リモート呼び出し向けに使えるようにします。

AI agent 向けの利用シーン

これはこのプロジェクトの中核となる利用シーンです。以前は Claude Code / Cursor / Codex Agent に「ついでに 1 枚描いて」と頼もうとすると、たいてい追加で OPENAI_API_KEY を入れるか、「画像生成はできません」と言われることになりました。この skill を入れると：

$ npx skills add leeguooooo/chatgpt-imagegen -g

agent は、あなたがすでに支払っているサブスクリプション枠をそのまま再利用します——新しい key、新しいアカウント、新しい環境変数は不要です。リポジトリ内の SKILL.md には、agent がいつこれを呼ぶべきか、サイズをどう選ぶか、エラーをどう処理するかがすでに書かれています。