使用ガイド

GPT Image API ガイド：モデル ID、ルーティング、移行

長期的に有効な地図：旧 OpenAI 画像名から GPT Image 2 まで、現在の HiAPI モデル ID、退役した Pro の代替案、そして各次のステップでどのページを見るべきかを示します。

Jun 24, 2026

簡潔な回答

新しい OpenAI 直結画像統合では、現在のモデル ID は gpt-image-2 です。新しい HiAPI 統合では、タスクがプロンプトから始まる場合は gpt-image-2/text-to-image を、1 枚以上参照画像から始まる場合は gpt-image-2/image-to-image を使用してください。

これらの名称が紛らわしいのは、「GPT-4o image」「ChatGPT image generation」「GPT Image API」「GPT Image 2」が関連するものの異なる製品インターフェースを指すために使われるからです。安全な方法は、まず呼び出す API を確認し、その API に対応するモデル ID とリクエスト契約を使うことです。

インターフェース	現在のモデルまたはセレクター	リクエストモード
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` または `/v1/images/edits`
OpenAI Responses API	対応するメインラインモデルと画像生成ツール	`/v1/responses` による対話型または多段階の画像処理
HiAPI テキストから画像	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI 画像から画像	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI は OpenAI Image API のリクエストボディをプロキシしません。統一された非同期タスク契約を通じて GPT Image ルーティングを提供するため、ホスト名を変更するだけでは移行は完了しません。

開発者が知るべき GPT Image の系譜

役に立つ系譜とは、実行可能な移行マップです。以下の名称がすべて、相互に置き換え可能な API モデルを指しているわけではありません。

古いコードや検索結果で見かける可能性のある名称	現在の状態	今どうすべきか
「GPT-4o image generation」または「ChatGPT image generation」	製品インターフェースまたは UI 上の表現であり、新しい画像リクエストに貼り付けられる現在の画像モデル ID ではない	まず API インターフェースを選択し、その現在のモデルとリクエスト契約を使用する
`chatgpt-4o-latest`	非推奨の ChatGPT モデルエイリアス。OpenAI の現在のモデルページでは画像入力が記載されており、画像出力ではない	画像生成の移行先として使用しないこと
`gpt-image-1`	OpenAI は前世代の非推奨画像生成モデルとして位置付けている	新しい画像処理を `gpt-image-2` に移行する
`gpt-image-1.5`	OpenAI は前世代の非推奨画像生成モデルとして位置付けている	新しい画像処理を `gpt-image-2` に移行する
`dall-e-2` または `dall-e-3`	非推奨となり OpenAI API から削除済み	OpenAI は現在の生成と編集に `gpt-image-2` の使用を推奨している
`gpt-image-2`	OpenAI の現在の直結画像モデル ID	OpenAI Image API と共に使用するか、タスクを下記の HiAPI スラッシュ ID にマッピングする

OpenAI の現在のドキュメントでは、gpt-image-2 を最も先進的な画像生成モデルとして説明し、テキストから画像の生成と画像編集を記載しています。 OpenAI 画像生成ガイドでは、単発の Image API と Responses API を通じた対話型画像生成も区別しています。上記のモデル状態の説明は、以下の公式ページに基づきます： GPT Image 2、 GPT Image 1.5、 GPT Image 1、 DALL-E 2、 DALL-E 3、 ChatGPT-4o、確認日は 2026 年 8 月 31 日です。

UI ワークフローから API ワークフローへ

ChatGPT の画像セッションは、モデル選択、状態、リトライ、ファイル処理を会話の背後に隠します。API 統合では、これらの決定を明示的に行う必要があります。

OpenAI 公式ガイドは、単発の生成や編集には Image API を、対話型で多ターンの画像処理には Responses API を使用することを推奨しています。HiAPI は第 3 の契約を使用します。各画像タスクは非同期タスクです。バックエンドがタスクを送信し、返された taskId を保存し、コールバックまたは後でのタスク詳細リクエストで最終結果を受け取ります。

UI セッションからのクリエイティブブリーフは、有用な開始プロンプトとして依然使えますが、API の実際のリクエスト schema に移し、出力をテストしてください。UI の製品名を model フィールドにコピーして、それが安定した API ID だと仮定しないでください。

HiAPI では、API key をサーバー上に保持し、次のようにタスクを送信します：

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

callback オブジェクトは、model と input と並ぶトップレベルに配置する必要があります。ローカルデバッグや突合では、GET https://api.hiapi.ai/v1/tasks/{taskId} をポーリングしてください。タスク成功後は、一時的な出力 URL を永続ストレージとして扱わず、data.output[].url から画像をダウンロードしてください。

このハブページでは意図的にリクエストを 1 つだけ示しています。ルーティング固有のフィールド、コールバック、ポーリング、コピー＆ペースト可能な例については、テキストから画像 API ドキュメントまたは画像から画像 API ドキュメントを参照してください。

旧 OpenAI 画像呼び出しを HiAPI に移行する

OpenAI モデルの移行とプロバイダー契約の移行は、2 つの独立した変更です。まず現在の画像タスクを選択し、次に HiAPI のタスク API 用にリクエストを書き換えます。

旧入力	現在の OpenAI 直結ターゲット	現在の HiAPI ターゲット
`gpt-image-1`、`gpt-image-1.5`、または DALL-E ID によるテキストから画像	`gpt-image-2` 生成	`gpt-image-2/text-to-image`
`gpt-image-1` または `gpt-image-1.5` による画像編集	`gpt-image-2` 編集	`gpt-image-2/image-to-image`
UI のみの ChatGPT または GPT-4o 画像ワークフロー	インタラクション設計に応じて OpenAI Image API または Responses API を選択	HiAPI のテキストから画像または画像から画像のタスクルートを選択

HiAPI に移行する際は、同期または OpenAI 固有のレスポンス処理を、taskId の永続化、終端状態の処理、出力のダウンロードに置き換えてください。プロンプトと出力を再検証し、インターフェース間でピクセル単位の一致を約束しないでください。

旧 HiAPI モデル名を移行する

HiAPI は現在、タスク固有のスラッシュ ID とトップレベルのルートセレクターを使用しています。新しいコードは以下の正規リクエスト形式を使用すべきです。

旧 HiAPI 名	現在のリクエスト
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"` に加えて `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` に加えて `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` に加えて `route: "ext"`

公開価格データでは、ルーティング付きの項目を gpt-image-2/text-to-image@ext または gpt-image-2/image-to-image@ext と表記する場合があります。HiAPI はルート修飾形式も受け付けますが、モデルドキュメントではベースのスラッシュ ID にトップレベルの route フィールドを加える形式を使用しています。その方がルーティング固有の入力 schema を明確に確認できるからです。

退役した HiAPI Pro ID を置き換える

HiAPI は 2026 年 7 月 2 日に 2 つの旧 Pro ID を退役させました。これらは現在の公開価格データに表示されず、新しいサンプルにも残すべきではありません。

退役した ID	代替案
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

今回のモデル移行では、旧 Pro のすべてのパラメータが完全に同じ効果を生み出すことは保証されません。該当するモデルドキュメントの現在のルーティング schema を確認し、本番切り替え前に代表的なプロンプトと参照画像でテストを実行してください。

次にどこを見るべきか

本ページは名称、系譜、移行に関するものです。回答したい質問に応じて、適切な参照先を選んでください：

開始と統合

GPT Image 2 モデルページで現在のモデルと Playground を確認。
GPT Image 2 画像から画像モデルページで Playground での参照画像編集を確認。
GPT Image 2 テキストから画像ドキュメントで standard、beta、ext のリクエストフィールドを確認。
GPT Image 2 画像から画像ドキュメントで standard および ext の編集フィールドを確認。参照画像の命名差異も含みます。
GPT Image 2 API 価格で現在のルート表、参照画像の追加項目、予算計算を確認。
HiAPI リアルタイム価格で現在のモデルカタログ全体を確認。

ユースケースと実測エビデンス

比較と選定

よくある質問

現在の GPT Image API モデル ID は何ですか？

OpenAI の直結 Image API では gpt-image-2 です。HiAPI では、タスクがテキストから始まるか参照画像から始まるかに応じて、gpt-image-2/text-to-image または gpt-image-2/image-to-image を使用してください。

裸のモデル名 `gpt-image-2` を HiAPI に送信できますか？

新しい HiAPI コードでは裸の名称を使用しないでください。現在の正規 ID は上記に示したタスク固有のスラッシュ名であり、価格、schema、モデルページのルーティングもより明確になります。

HiAPI は OpenAI の `/v1/images/generations` エンドポイントを使用しますか？

いいえ。HiAPI の画像モデルは POST /v1/tasks を使用し、その後最終コールバックまたは GET /v1/tasks/{taskId} で結果を取得します。OpenAI Image API と HiAPI タスク API のリクエストとレスポンスの契約は異なります。

コールバックはどこに置くべきですか？

callback はタスクボディのトップレベルに、model と input と並べて配置してください。callback.when: "final" を使用し、受信サービスを taskId で冪等に保ってください。成功も失敗も終端結果だからです。

`gpt-image-2-pro` の代替は何ですか？

gpt-image-2/text-to-image を使用してください。退役した画像から画像の Pro ID については、gpt-image-2/image-to-image を使用します。切り替え前に現在の入力 schema を確認し、代表的なタスクをテストしてください。

タグ画像API 移行

すべての記事を見る →