Skip to Content
モデルの使い方GPT Image手持ちのツールで画像生成キーを用意する

手持ちのツールで画像生成

コードを書く必要はありません。普段使っているツールに GPT Image を接続すれば、そのまま画像を生成できます。

ステップ 1:キーを用意する

このステップの目的: キーはアカウントのパスワードのようなものです。ツールはこのキーを使って OfoxAI を呼び出します。

  1. OfoxAI コンソール を開き、Settings → API Keys に移動して Create New Key をクリックします。
  2. すぐにコピーして安全な場所に保管してください。キーは作成時に一度だけ表示されます。 ダイアログを閉じると再表示できません。

このツール専用のキーを作成してください。使わなくなったときや漏えいが心配なときは、そのキーだけを削除すれば、他には影響しません。

おおよその費用: 料金は品質によって異なります。OpenAI 公式の参考価格では、1024×1024 の画像 1 枚は最低品質で 1 セント未満、gpt-image-2 の高品質で約 21 セントです。まず最低品質で試し、満足できたら品質を上げてください。品質と価格を参照してください。

キーはツールの設定画面、またはコーディングアシスタントが指定するファイルにのみ入力してください。チャットで送信したり、スクリーンショットを共有したりしないでください。

次へ: お使いのツールの種類を確認します。

ステップ 2:ツールの種類を確認する

このステップの目的: ツールによって接続方法が異なるため、まずお使いのツールがどちらに当てはまるかを確認します。

お使いのツール例接続方法
チャット・画像生成クライアント:画面があり、モデルプロバイダーを自分で追加できるCherry Studio、LobeHub などいくつかの設定を入力する
AI アシスタント・コーディングアシスタント:対話でコードを書かせたり、パソコンを操作させたりするClaude Code、Codex、ZCode、OpenClaw、WorkBuddy などプロンプトをコピーして送信する

主なツールの対応状況(2026-09-30 確認):

ツール接続方法
Cherry Studioチャット・画像生成クライアント。 モデルを追加する際に「エンドポイントタイプ」を「画像生成 (OpenAI)」に設定してください。設定しないと、「ペインティング」にモデルが表示されません。プロバイダーの追加方法は Cherry Studio の設定を参照してください
LobeHubチャット・画像生成クライアント。ただし組み込みの「OpenAI」プロバイダーを使用します。 LobeHub で自分で追加したモデルは画像タイプに設定できないため、新しいプロバイダーは作成しないでください。組み込みの OpenAI プロバイダーで「API プロキシアドレス」を https://api.ofox.ai/v1 に変更し、キーを入力して、画像生成時に GPT Image 2 を選択します。2.5 の 2 モデルはまだ組み込みリストにありません
Chatbox現時点では非対応です。 画像生成機能は現在 Chatbox 独自のサービスでのみ動作し、外部プロバイダーは使用できません
WorkBuddyAI アシスタント・コーディングアシスタント。 モデル設定ではチャットモデルのみ接続できます。まず WorkBuddy の設定に従って接続し、その後に下記のプロンプトを送信してください
Claude Code、Codex、ZCode、OpenClawAI アシスタント・コーディングアシスタント。 下記のプロンプトをそのまま送信してください

判断がつかない場合:設定に「プロバイダーを追加」「カスタム API」のような項目があれば、チャット・画像生成クライアントの手順に従ってください。普段コードを書かせたりタスクを任せたりしているツールであれば、AI アシスタント・コーディングアシスタントの手順に従ってください。

次へ: 該当する方法に進みます。

チャット・画像生成クライアント

ツールが画像生成に対応しているか確認する

このステップの目的: お使いのツールが外部の画像生成モデルを使えるかを確認します。すべてのツールが対応しているわけではありません。

次の 2 つを両方満たしている必要があります。

  • 「ペインティング」「画像生成」「描画」などの入口がある。
  • その入口で、自分で追加したプロバイダーとモデルを選択できる。

ツールによっては、描画機能が組み込みモデルでしか動作せず、追加したプロバイダーを選択できないものがあります。そのようなツールでは GPT Image を使えません。不明な場合は、ツール自体のドキュメントを確認してください。条件を満たさない場合は、AI アシスタント・コーディングアシスタントの手順に従ってください。

OfoxAI をプロバイダーとして追加する

このステップの目的: リクエストの送信先と、使用するキーをツールに設定します。

このツールですでに OfoxAI のチャットモデルを接続済みの場合は、 そのプロバイダーを使い、次のステップに進んでください。

まだ接続していない場合は、 ツールごとの設定ガイドに従ってください。各ステップのスクリーンショットがあります:Cherry Studio · LobeHub · すべてのツール。主な入力項目は次のとおりです。

プロバイダー追加時に入力する項目
プロバイダータイプOpenAIOpenAI の選択肢がない場合は「OpenAI 互換」を選択してください
API URLhttps://api.ofox.ai/v1一部のツール(NextChat など)では末尾の /v1 が不要です。各ツールの設定ガイドに従ってください
API キーステップ 1 でコピーしたキーを貼り付けます

LobeHub では新しいプロバイダーを作成しないでください。 LobeHub で自分で追加したモデルは画像タイプに設定できないため、組み込みの「OpenAI」プロバイダーを使用します。

LobeHub:組み込みの OpenAI プロバイダーに入力する項目
API プロキシアドレスhttps://api.ofox.ai/v1
API キーステップ 1 でコピーしたキーを貼り付けます
画像生成時に選択GPT Image 22.5 の 2 モデルはまだ LobeHub の組み込みリストにありません

画像生成モデルを追加する

このステップの目的: 画像生成に使うモデルをツールに設定します。

このプロバイダーにモデルを手動で追加し、次のいずれかのモデル ID をコピーしてください。

モデル追加時に入力する項目
モデル IDopenai/gpt-image-2.5-flare日常的な画像生成向け、高速。まずはこちらをお試しください
モデル IDopenai/gpt-image-2.5-sunburst編集向け、元の画像により近い仕上がり
モデルタイプ画像生成Cherry Studio では「エンドポイントタイプ」で「画像生成 (OpenAI)」を選択します。その他のツールではチャットではなく画像生成の選択肢を選んでください

画像を生成する

このステップの目的: 画像生成の入口で追加したモデルを選び、説明文を入力して、テスト用の画像を 1 枚生成します。

ツールで品質を選択できる場合は、まず低(low)で動作を確認してから上げてください。品質が高いほど料金が高く、時間もかかります。高品質の画像は数分かかる場合があります。

画像が生成されない場合は、よくある質問を参照してください。

AI アシスタント・コーディングアシスタント

コーディングアシスタントをまだインストールしていない場合は、先にガイドに従ってインストールしてください:Claude Code、Codex、OpenClaw。

コーディングアシスタントにできることは次の 2 つです。必要なほうを選んでください。

  • 画像を生成してもらう:チャットで画像を説明すると、生成してパソコンに保存してくれます。
  • 自分のプロジェクトに組み込む:たとえば、開発中のウェブサイトやミニプログラムに画像生成機能を持たせたい場合です。

プロンプトをコーディングアシスタントに送信する

このステップの目的: コーディングアシスタントに、何をするのか、どうすれば安全に進められるのかを伝えます。まずキーの保存を手伝ってから、作業に取りかかります。

目的に合ったプロンプトをコピーし、Claude Code、Codex、ZCode、OpenClaw、WorkBuddy のいずれかに送信してください。

画像を生成してもらう

チャットで画像を生成したい場合は、こちらをコピーしてください。

OfoxAI の GPT Image モデルで画像を生成したいです。OfoxAI コンソールで API キーはすでに作成済みです。技術にはあまり詳しくないので、1 ステップずつ案内してください。各ステップの前に、何をするのか、次に何をするのかをわかりやすい言葉で説明してください。

【ステップ 1:キーを安全に保存する】
1. 現在のフォルダーに .env ファイルを作成し、OFOX_API_KEY= という 1 行だけを書いてください(値は空のまま)。現在のフォルダーがコードリポジトリの場合は、.env を .gitignore に追加してください。
2. ファイルの場所と開き方を教えてください。= の後ろには自分でキーを貼り付けて保存します。
3. このチャットでキーを送るよう求めないでください。誤って貼り付けてしまった場合は、コンソールでそのキーを削除して新しいキーを作成するよう注意してください。
4. 私が「完了」と伝えるまで先に進まないでください。

【ステップ 2:画像生成の準備をする】
5. .env から OFOX_API_KEY を読み込み、POST https://api.ofox.ai/v1/images/generations を呼び出して画像を生成する小さなスクリプトを書いてください。
6. モデルは openai/gpt-image-2.5-flare、quality は low、size は 1024x1024 とし、クライアントのタイムアウトを 600 秒に設定してください。
7. 返される data[0].b64_json は素の base64 です。デコードして PNG として、現在のフォルダー内の images フォルダーに保存してください。
8. キーを出力したり、スクリプトに書き込んだりしないでください。

【ステップ 3:1 枚試す】
9. まず「白いテーブルの上の赤いリンゴ」を生成し、画像の保存場所と開き方を教えてください。
10. その後は、私が画像を説明するたびにこのスクリプトで 1 枚生成し、保存場所を教えてください。私が「品質を上げて」と言ったら、quality を medium または high に変更し、料金が高くなり時間もかかることを伝えてください。

【エラーが発生したとき】
11. HTTP ステータスとエラーの全文(error.message と request_id を含む)を出力し、https://ofox.ai/ja/docs/develop/models/gpt-image#errors で原因を調べ、1 か所だけ変更して再試行してください。
12. 2 回修正しても同じエラーが続く場合は、作業を止めて問題をわかりやすく説明し、OfoxAI に問い合わせられるよう request_id とエラーメッセージの原文を教えてください。
13. 画像は 1 回に 1 枚ずつ生成し、自分の判断でまとめて再試行しないでください(リクエストごとに課金されます)。

自分のプロジェクトに組み込む

ウェブサイトやアプリに画像生成機能を持たせたい場合は、こちらをコピーしてください。

このプロジェクトに OfoxAI の GPT Image による画像生成を組み込みたいです。OfoxAI コンソールで API キーはすでに作成済みです。技術にはあまり詳しくないので、1 ステップずつ案内してください。各ステップの前に、何をするのか、次に何をするのかをわかりやすい言葉で説明してください。

【ステップ 1:キーを安全に保存する】
1. プロジェクトに .env ファイルを作成し、OFOX_API_KEY= という 1 行だけを書いてください(値は空のまま)。
2. .env を .gitignore に追加し、コミットやアップロードされないようにしてください。
3. ファイルの場所と開き方を教えてください。= の後ろには自分でキーを貼り付けて保存します。
4. このチャットでキーを送るよう求めないでください。誤って貼り付けてしまった場合は、コンソールでそのキーを削除して新しいキーを作成するよう注意してください。
5. 私が「完了」と伝えるまで先に進まないでください。

【ステップ 2:コードを書く】
6. OpenAI 公式 SDK を使い、base_url を https://api.ofox.ai/v1 として OfoxAI の画像エンドポイントを呼び出してください。キーは .env の OFOX_API_KEY から読み込みます。
 - テキストからの画像生成:POST /v1/images/generations
 - 編集、複数画像の合成、インペインティング:POST /v1/images/edits(multipart アップロード)
7. モデル ID は完全な形で指定してください:openai/gpt-image-2.5-flare(編集には openai/gpt-image-2.5-sunburst)。
8. quality は必ず明示的に指定し、開発中は low を使ってください。省略するとモデルがティアを決定します。
9. size は次の条件をすべて満たす必要があります:幅と高さが 16 で割り切れる、長辺 ≤ 3840、アスペクト比が 1:3 から 3:1 の範囲内、総ピクセル数 ≥ 655,360。
10. 結果は data[0].b64_json に data: プレフィックスなしの素の base64 として返されます。デコードして画像ファイルとして保存してください。
11. クライアントのタイムアウトを 600 秒に設定してください。
12. response_format、input_fidelity、style は送信しないでください。
13. キーをコード、ログ、エラーメッセージに書き込まないでください。リクエストを出力する際は Authorization ヘッダーをマスクしてください。

【ステップ 3:テストする】
14. quality=low、size=1024x1024 で実際に 1 回呼び出し、200 が返り画像が開けることを確認してから、画像の保存場所を教えてください。
15. テスト中は 1 回に 1 枚ずつ生成し、ループでまとめてテストしないでください(リクエストごとに課金されます)。

【エラーが発生したとき】
16. HTTP ステータスとレスポンスボディの全文(error.message と request_id を含む)を出力し、https://ofox.ai/ja/docs/develop/models/gpt-image#errors で原因を調べてください。
17. 429 の場合は待ってから再試行してください。その他のエラーは、そのまま再試行せずに先にリクエストを修正してください。
18. 2 回修正しても同じエラーが続く場合は、作業を止めて問題をわかりやすく説明し、OfoxAI に問い合わせられるよう request_id とエラーメッセージの原文を教えてください。

【公開前のセルフチェック】
19. 私が「公開の準備ができた」と言ったら、次の各項目を確認して結果を教えてください:コードとコミット履歴にキーが含まれていない、.env が .gitignore に入っている、すべてのリクエストで quality を指定している、タイムアウトが 600 秒以上、エラー時にステータスコード・エラーの原文・request_id を出力する。

参考資料:
- このファミリーの値と制約:https://ofox.ai/ja/docs/develop/models/gpt-image
- エンドポイントの共通構造:https://ofox.ai/ja/docs/api/openai/images

指示に従ってキーをファイルに貼り付ける

このステップの目的: キーをチャットに出さず、パソコン上のファイルにだけ保存します。

コーディングアシスタントが .env ファイルの場所を教えてくれます。ファイルを開き、OFOX_API_KEY= の後ろにキーを貼り付けて保存し、「完了」と返信してください。

最初の画像の生成を確認する

このステップの目的: すべてが正しく接続されていることを確認します。

コーディングアシスタントはまずテスト用の画像を 1 枚生成し、保存場所を教えてくれます。その画像を開ければ準備完了です。以降は、欲しい画像をチャットで伝えるだけです。

この 2 つのプロンプトで防げること

要件指定しなかった場合
キーは .env に保存し、チャットで送信しないキーがコードに書き込まれたり、インターネット上にアップロードされたりするおそれがある
モデル ID はドキュメントからコピーする大文字・小文字を誤ると 404 が返る
デフォルトで low 品質を使うモデルがティアを決定し、品質と費用が安定しない
タイムアウトは 600 秒高品質では数分かかる場合があり、途中で切断すると画像は失われるが、リクエストは課金される
エラーの全文を出力するコーディングアシスタントには「リクエスト失敗」しか見えず、原因を推測するしかない
2 回失敗したら止めるコーディングアシスタントが再試行を繰り返し、そのたびに費用がかかる

問題が発生した場合

このステップの目的: コーディングアシスタントに原因を突き止めて自分で修正させます。ほとんどのエラーは、実際のエラーメッセージを見れば解決できます。

エラーが発生したら、次のプロンプトを送信してください。

デバッグ用プロンプト

画像生成に失敗したときに、コーディングアシスタントに送信します。

直前の画像生成リクエストが失敗しました。次の順序で調査し、結果をわかりやすい言葉で説明してください。
1. そのリクエストの HTTP ステータスとエラーの全文を出力してください(Authorization ヘッダーはマスクしてください)。
2. error.message を読み、https://ofox.ai/ja/docs/develop/models/gpt-image#errors で原因を調べてください。
3. 1 か所だけ変更し、quality=low、size=1024x1024 で 1 回だけ再試行してください。
4. それでも失敗する場合は作業を止め、何が問題だったかを説明し、request_id とエラーメッセージの原文を教えてください。

それでも解決しない場合は、コーディングアシスタントから受け取った request_id とエラーメッセージを添えて OfoxAI にお問い合わせください。該当するリクエストを直接確認できます。キーそのものは絶対に送信しないでください。

よくある質問

自分のツールで GPT Image を使って画像を生成できますか?

チャット・画像生成クライアントの場合は、2 つの条件があります。「ペインティング」や「画像生成」などの入口があること、そしてその入口で自分で追加したプロバイダーとモデルを選択できることです。組み込みモデルでしか描画できないツールは接続できません。Claude Code、Codex、ZCode、OpenClaw などのコーディングアシスタントはすべて利用できます。このページのプロンプトを送信すると、画像を生成する小さなスクリプトを書いてくれます。

Cherry Studio で GPT Image を画像生成に使うにはどう設定しますか?

Cherry Studio で OpenAI タイプのプロバイダーを追加し、API アドレスに https://api.ofox.ai/v1、キーを入力します。次に、モデル openai/gpt-image-2.5-flare を手動で追加し、「エンドポイントタイプ」を「画像生成 (OpenAI)」に設定すると、「ペインティング」に表示されます。

LobeHub で GPT Image を使って画像を生成できますか?

はい。組み込みの OpenAI プロバイダーを使用します。「API プロキシアドレス」を https://api.ofox.ai/v1 に変更し、キーを入力して、画像生成時に GPT Image 2 を選択してください。LobeHub で自分で追加したモデルは画像タイプに設定できないため、新しいプロバイダーは作成しないでください。GPT Image 2.5 の 2 モデルはまだ組み込みリストにありません。

ツールで接続エラーや 404 が表示される場合はどうすればよいですか?

次の 3 点を確認してください。API URL が https://api.ofox.ai/v1 になっているか(NextChat など一部のツールでは /v1 が不要)、キーが余分な空白なしで完全にコピーされているか、モデル ID がドキュメントから大文字・小文字も含めて正確にコピーされているか。

画像 1 枚あたりの費用と所要時間はどのくらいですか?

料金は品質によって異なります。OpenAI 公式の参考価格では、1024x1024 の画像 1 枚は low で 1 セント未満、gpt-image-2 の high で約 21 セントです。所要時間は品質とサイズによって変わり、高品質では数分かかる場合があります。実際の課金は各リクエストの使用量に従います。OfoxAI のリアルタイム価格はモデルページを参照してください。まず low で動作を確認し、必要に応じて品質を上げてください。

誤ってキーをチャットで送信してしまった場合はどうすればよいですか?

OfoxAI コンソールでそのキーを削除し、新しいキーを作成して、上記の手順どおりにツールの設定または .env ファイルに入力してください。削除した古いキーは使用できなくなります。

Last updated on