gpt-image-2 APIをBearer tokenで呼び出し、約45秒でホスト型のPNGが返ってきます。text-to-imageとimage-to-imageは同一エンドポイントを共有。1枚2クレジット、契約金もSDKインストールも不要。keyを発行してコーヒーが届く前に最初のcurlを走らせましょう。
導入実績 10,000人以上 の開発者がgpt-image-2 APIで開発中です
1つのエンドポイント、Bearer認証、ホスト型出力。追加の配線は一切不要です。
gpt-image-2 APIは、promptと最大4枚のreference imagesを本番投入可能なPNGに変換するREST surfaceです。Bearer token付きで/api/v1/images/generateにPOSTするとtask_idが返り、/api/v1/images/task/[id]をpollして完了を待ちます。すべてのレスポンスはJSON形式で、2xxでは成功エンベロープ、4xxおよび5xxでは安定したエラーコードとrequest_idを含むエラーエンベロープが返されます。各レンダリング結果はR2 CDNに保存されHTTPSで配信されるため、URLをそのままhotlinkすることも、自前のバケットへmirrorすることも可能です。クレジットは投入時にアトミックに差し引かれ、タスクが失敗した場合は自動的に返還されるため、請求が実出力から乖離することはありません。surfaceはユーザー単位で分離されており、keyは所属アカウントのクレジット残高を継承し、プログラム経由で作成されたタスクのみ参照可能です（Web studio上のタスクは見えません）。送信データはすべてJSONで、multipartアップロード、SDKロックイン、隠れリトライは一切ありません。
POST /api/v1/images/generateがgpt-image-2 APIのtext-to-imageとimage-to-imageを両方処理します。reference imagesを渡すと自動的にモードが切り替わり、リクエストボディのその他の部分は同一のままです。
Authorization: Bearer YOUR_API_KEYで認証します。gpt-image-2 APIはクエリ文字列でのkey渡しを拒否するため、tokenがCDNやプロキシのログに漏れることはありません。
完了したgpt-image-2 APIタスクは安定したhttps://file.gptimg.coのURLを返します。署名付きURLの期限切れも、ダウンロード＆再ホストのループも、一時リンクもありません。
gpt-image-2 APIはsquare、portrait、landscape、widescreen、ultra-wideをカバーします。プラットフォームに必要な比率を選んで出荷するだけ。生成後のレターボックス処理は不要です。
gpt-image-2 APIがfailedタスクを返した場合、クレジット課金は自動的に返還されます。リコンサイルスクリプトを書く必要はありません。
gpt-image-2 APIの全レスポンス（成功・エラー問わず）にX-Request-Idヘッダーと、ボディ内の対応するrequest_idが含まれます。サポートチケットが数日ではなく数分で解決します。
1つのpromptエンドポイント、立ち上げるインフラ不要、ファイナンスに説明できる課金体系
GPU podをプロビジョニングしたりベンダー契約を交渉したりせずに、新しい画像機能を出荷できます。gpt-image-2 APIはレンダリングごとの定額制で、1:1画像は2クレジット、バッチサイズに線形に比例します。HTTP呼び出し1本でクライアントをバックエンドに組み込み、機能をフラグの裏に置き、利用状況から価格帯を見つけてください。チームはアイデアからステージングまで半日以内で到達できます。
最大4枚のリファレンス付きimage-to-imageを、すべて同じエンドポイントで
reference_imagesに1〜4本のhttps URLを渡すと、gpt-image-2 APIは自動的にimage-to-imageモードに切り替わります。チームはstyle transfer、restyle、product swap、identity-preservingな編集に活用しています。別個のeditエンドポイントも、multipartフォームも、base64の肥大化もありません。http(s) URLのみを受け付けるため、リクエストボディは小さく、ログは読みやすく保たれます。
安定したエラーコード、request_id相関、プロバイダー非公開のメッセージ
gpt-image-2 APIの全レスポンスには、サポートチケットで引用できるrequest_idが含まれています。エラーはerror.code、error.message、error.request_idフィールドを持つ統一エンベロープに従います。あらゆる失敗モードを少数の安定コードでカバーします — UNAUTHORIZED、INVALID_REQUEST、INSUFFICIENT_CREDITS、NOT_FOUND、RATE_LIMITED、INTERNAL_ERROR。上流プロバイダー名は全メッセージから除去されているため、何かが壊れてもクライアント側にベンダーの内部情報が漏れることはありません。
定額クレジット、R2ミラーリング、両モード対応の単一surface
gpt-image-2 APIはレンダリング単位の定額クレジット価格、24時間で失効しないホスト型PNGのURL、そしてtext-to-imageとimage-to-imageをカバーする単一エンドポイントを提供します。同じ画像をOpenAIのimagesエンドポイントで生成すると、サイズと品質によって$0.01〜$0.20、さらにダウンロードして再ホストが必要な一時署名URLが付いてきます。n=4のバッチは線形クレジットで支払い可能 — 別個のエンドポイントも、隠れた品質ティア価格も、座席単位のライセンスもありません。
4ステップ。最初のcurlまで5分以内。
サインインし、Settings → API Keysを開いてCreateをクリックし、平文のkeyを1度だけコピーします。gpt-image-2 APIはkeyを作成時のみ表示するため、シークレットマネージャーに保管してください。
prompt、aspect_ratio、n、そして任意のreference_imagesを含むJSONを送信します。gpt-image-2 APIは即座にtask_idとprocessingステータスを返します。
送信後10秒待ってから、gpt-image-2 APIのstatusがcompletedまたはfailedに切り替わるまで5秒ごとにpollします。エンドツーエンドのレイテンシは通常45〜60秒です。
完了したgpt-image-2 APIのレスポンスには、安定したhttps://file.gptimg.coのURLが含まれます。hotlinkするか、自前のストレージへmirrorするか、そのままフロントエンドへ渡してください。
統合、料金、レートリミットについて
gpt-image-2 APIはサインアップ時の無料クレジット、2クリックで取得できるBearer token、そしてpromptからホスト型PNGまで45秒のラウンドトリップを備えて提供中です。SDKインストールもクレジットカード登録も不要で始められます。