GPT Image 2 API

OpenAI / Azure-画像生成提供中

1K medium で $0.048/枚から-10%$0.053 公式価格

テキストto画像画像to画像インペイントマスク画像内テキストポスター・インフォグラフィックトークン課金

ルート状態

提供中非同期タスク追跡

モデルの強み

プロンプト忠実度が高く、画像内テキストも読める

ユースケース

広告、ポスター、インフォグラフィック、商品クリエイティブ、キャラクターシート

入力

テキストプロンプト（参照画像・マスクは任意）

出力

画像

Playground 料金概要 API

API を組み込む前に GPT Image 2 を試す

本格導入の前に、出力品質を確認し、1 リクエストのトークンコストを見積もり、サンプルを 1 枚生成できます。

Create image task

Fixed to gpt-image-2

Text-to-image, image-to-image and mask-guided editing. Billed by the tokens the upstream usage object reports.

Promptプロンプト例をもっと見る →

Reference images

Upload source or reference images for image-to-image and editing. Each one adds image input tokens.

0/16 files

Size

Resolution

Pixel budget for the chosen ratio: 1K about 1.05 MP, 2K about 4.19 MP, 4K is 8.29 MP.

Quality

Rendering effort. It drives the output token count, so it is the single biggest cost lever.

Background

Transparent keeps an alpha channel in the output. This is a Preview feature — results may be unstable.

Count1

Number of images per request (1-10). Cost scales linearly with the count.

Estimate $0.0281.8608 cr

medium quality + 16:9 @ 1K + 0 reference images x 1

Ready

History

生成結果は24時間保存されます。必要なものはお早めにダウンロードしてください。

Generated GPT Image 2 tasks will appear here.

チャージする前にテスト費用を把握する

サンプル 1 枚のコストを起点にテスト予算を選び、計算機で自分のケースを見積もれます。トークン単価表は最下部にあります。

First Test Cost

Text-to-Image - 1K - 1:1 - medium

1K prompt-only

Credits3.2241

One 1K prompt-only image

Approx. Cost$0.048

About 208 tests with $10 in credits.

Iterate prompts on low quality at 1K to save tokens, then promote the final render to high. Each reference image in image_urls adds input tokens.

EvoLink 価格$0.048

公式価格$0.053

削減率-10%

Testing Budget Guide

Pick an amount based on how many tests you expect.

Add Credits

$10

About 208 tests

Good for a first validation.

$50

About 1042 tests

Good for prompt iteration.

$100

About 2083 tests

Good before production integration.

Common Cost Examples

Draft iterationLow - 1K - prompt only

$0.0053/image-10%

0.3599 cr/image$0.0059 公式価格

Reference editMedium - 1K - one reference image

$0.059/image-10%

3.9761 cr/image$0.065 公式価格

Final quality checkHigh - 2K - prompt only

$0.386/image-10%

26.2034 cr/image$0.429 公式価格

Estimated cost for one generated 1:1 image. Final cost is settled against the token counts the upstream usage object reports.

Model Pricing

This page serves two models and they are billed differently. Each block states its own rule, so read the badge before comparing the numbers.

GPT Image 2gpt-image-2Token-based

Billed by token, so there is no fixed per-image price. These are the raw rates; what a request actually costs depends on its size, quality, reference images and count. Use the calculator below to price your own case.

Item	Rule	Rate	Billing
Image output tokens	The generated image itself. Token count grows with the resolution tier and the quality tier.	$0.027/1K tokens-10% 1.836 cr/1K tokens$0.030 公式価格	Output tokens
Image input tokens	Applied to each reference image in image_urls, and to a mask when one is sent.	$0.0072/1K tokens-10% 0.4896 cr/1K tokens$0.0080 公式価格	Input tokens
Image cached input tokens	Charged only when the upstream usage object reports cached image tokens.	$0.0018/1K tokens-10% 0.1224 cr/1K tokens$0.0020 公式価格	Input tokens
Text input tokens	Produced by the prompt itself. Typically under 1% of a request.	$0.0045/1K tokens-10% 0.306 cr/1K tokens$0.0050 公式価格	Input tokens
Text cached input tokens	Charged only when the upstream usage object reports cached text tokens.	$0.0012/1K tokens-10% 0.0765 cr/1K tokens$0.0013 公式価格	Input tokens

Image output tokens

The generated image itself. Token count grows with the resolution tier and the quality tier. - Output tokens

$0.027/1K tokens-10%

1.836 cr/1K tokens$0.030 公式価格

Image input tokens

Applied to each reference image in image_urls, and to a mask when one is sent. - Input tokens

$0.0072/1K tokens-10%

0.4896 cr/1K tokens$0.0080 公式価格

Image cached input tokens

Charged only when the upstream usage object reports cached image tokens. - Input tokens

$0.0018/1K tokens-10%

0.1224 cr/1K tokens$0.0020 公式価格

Text input tokens

Produced by the prompt itself. Typically under 1% of a request. - Input tokens

$0.0045/1K tokens-10%

0.306 cr/1K tokens$0.0050 公式価格

Text cached input tokens

Charged only when the upstream usage object reports cached text tokens. - Input tokens

$0.0012/1K tokens-10%

0.0765 cr/1K tokens$0.0013 公式価格

EVOLINK · PRICE EST.gpt-image-2

× 1 · real-time

Figures are estimates. Final charges are based on actual token usage.

Your estimate

~$0.0050.360

Per $10

≈ 1,889 images

low quality · 1K · 1:1

Official· saves ~10%

~$0.0060.400

Tokens per image

image output196

image input0

text input0

Quality

Size

Resolution

Aspect

Count

Ref images

Prompt

0 chars · ~0 tokens

GPT Image 2 Betagpt-image-2-betaFlat per call

One flat rate per call, whatever the aspect ratio - no token accounting and nothing to estimate. Auto or aspect-ratio sizes at the 1K tier only, one image per call. The OpenAI list price has no equivalent for this route, so no official comparison is shown.

Item	Rule	Rate	Billing
1K output	Any aspect ratio or auto, at the 1K tier. One image per call, regardless of prompt length or reference images.	$0.015/image 1.02 cr/image	Per call

1K output

Any aspect ratio or auto, at the 1K tier. One image per call, regardless of prompt length or reference images. - Per call

$0.015/image

1.02 cr/image

Per $10

≈ 666 images

1K each

GPT Image 2 API の概要

GPT Image 2 は ChatGPT Images 2.0 と同時期にリリースされ、モデル ID gpt-image-2 として API から利用できます。文字量の多い画像生成と高忠実度の編集に向いています。ChatGPT 側ではオーケストレーションやツールが追加されることがありますが、それらは素の画像モデルとは別のものです。

モデル ID

gpt-image-2

適した用途

文字量の多い画像生成と高忠実度の画像編集

コストの内訳

プロンプト、サイズ、品質、参照画像の入力

出力の上限

カスタムサイズは一辺最大 3840 px。大きな出力はまだ実験的な機能です

GPT Image 2 で作れるもの

テキストプロンプトまたは参照画像から高忠実度の画像を生成します。ポスターのレイアウト、情報量の多いインフォグラフィック、キャラクターシート、商品クリエイティブ、マスクを使った編集ワークフローが得意です。

プロンプト例をもっと見る

入力

テキスト / 画像

出力

画像

サイズ

Auto / 15 種類の比率 / カスタムピクセル

品質

Low / Medium / High

生成例

情報密度の高いレイアウトでの文字の読みやすさが向上

グラフ、ラベル、多段組みのテキストをより読みやすい形で描画しやすくなり、文字まわりの後処理を減らせます。

サンプル出力です。実際の結果はプロンプトと設定によって変わります。

マルチパネルのキャラクターシート

ターンアラウンド、表情グリッド、装備の内訳を 1 枚の中でより高い一貫性で保ちやすくなります。

サンプル出力です。実際の結果はプロンプトと設定によって変わります。

ポスター品質の構図とタイポグラフィ

タイトル、タグライン、クレジットがプロンプトで指定したレイアウトにより忠実に配置され、印刷物のような階層を作りやすくなります。

サンプル出力です。実際の結果はプロンプトと設定によって変わります。

できること

文字量の多いポスター・インフォグラフィック

タイトル、タグライン、グラフのラベル、多段組みのコピーをプロンプトでそのまま画像内に描画 — GPT Image 2 が最も話題になるワークロードです。

キャラクターシートと一貫した IP アート

ターンアラウンド、表情グリッド、装備の内訳を 1 枚に収め、参照画像により生成を重ねても同じキャラクターを保てます。

EC 商品画像と UGC 風広告

商品写真 1 枚からメイン画像、パッケージモックアップ、ライフスタイルシーン、広告クリエイティブを作成。商品はそのまま見分けられます。

API でキャンペーンビジュアルを一括生成

1 リクエストで最大 10 バリエーションを生成し、キャンペーン一式をスクリプトで量産。バッチ全体で 1 つのスタイルを維持します。

参照画像編集・スタイル転送・マスク

image_urls の最大 16 枚でスタイル・被写体の一貫性・変換を制御するか、アルファチャンネル付き PNG でマスク領域だけを再生成できます。

AI 動画ワークフローのファーストフレーム

ここでキーフレームを生成し、同じ API キーのまま Seedance でアニメーション化 — 下に専用ガイドを用意するほど検索されているワークフローです。

用途に合わせて画像モデルを選ぶ

項目	GPT Image 2	Nano Banana	Seedream
開始価格	約 $0.048/枚	より安価な選択肢あり	枚単位のティア制
課金方式	トークン課金	生成枚数課金	出力ティア別の枚数課金
出力品質	Low / Medium / High × 1K / 2K / 4K	モデルにより 1K / 2K / 4K	1K / 1.5K / 2K
参照入力	最大 16 枚＋マスク	モデル依存	最大 10 枚
向いている用途	ポスター、インフォグラフィック、画像内テキスト	高品質な画像生成	広告、商品クリエイティブ、画像編集

開始価格

GPT Image 2約 $0.048/枚

Nano Bananaより安価な選択肢あり

Seedream枚単位のティア制

課金方式

GPT Image 2トークン課金

Nano Banana生成枚数課金

Seedream出力ティア別の枚数課金

出力品質

GPT Image 2Low / Medium / High × 1K / 2K / 4K

Nano Bananaモデルにより 1K / 2K / 4K

Seedream1K / 1.5K / 2K

参照入力

GPT Image 2最大 16 枚＋マスク

Nano Bananaモデル依存

Seedream最大 10 枚

向いている用途

GPT Image 2ポスター、インフォグラフィック、画像内テキスト

Nano Banana高品質な画像生成

Seedream広告、商品クリエイティブ、画像編集

重要なポイント

size と resolution は組み合わせで効く

比率モードでは解像度ティアがピクセル予算を決めます（1K は約 1.05 MP、2K は約 4.19 MP、4K は 8.29 MP）。auto とカスタムピクセルのモードでは resolution は無視されます。

quality はレンダリング強度

low / medium / high は消費する出力トークン数を左右します。プロンプト調整は low、最終出力だけ high に上げるのが効率的です。

課金は usage に従う

上流の usage が返すトークン数に基づいて課金されます。実行前に見積もり、実行後は実数値で精算されます。

主要リクエストパラメータ

POST /v1/images/generations の出力とコストを左右するフィールドです。生成は非同期のため、返される task ID をポーリングするかコールバックを利用してください。画像リンクの有効期間は 24 時間なので、結果は早めに保存してください。完全なスキーマとコード例は API タブにあります。

パラメータ	型	役割
model	string · 必須	'gpt-image-2' はトークン課金の公式ルート、'gpt-image-2-beta' は 1K 固定料金ルートです。
prompt	string · 必須	テキスト指示。トークンルートではプロンプトのトークンがテキスト入力として計測されます。
size	string · デフォルト auto	'auto'、1:1 や 16:9 など 15 種類のアスペクト比のいずれか、または 16 の倍数で明示指定する WxH ピクセル。
resolution	string · 1K / 2K / 4K	比率モードでのピクセル予算。size が auto または明示ピクセルの場合は無視されます。
quality	string · low / medium / high	レンダリング強度。トークンルートでは出力トークン消費を左右します — 調整は low、最終レンダリングだけ high に。
background	string · opaque / transparent	出力のアルファチャンネル。既定は opaque。transparent は Preview 機能で、出力が安定しない場合があります。
n	integer · 1–10	gpt-image-2 の 1 リクエストあたりの生成枚数で、コストは線形に増えます。GPT Image 2 Beta は 1 回の呼び出しで 1 枚を返します。
image_urls	array · 最大 16 枚	image-to-image と編集用の参照画像。1 枚ごとに画像入力トークンが加算されます。
mask_url	string · 任意	アルファチャンネル付き PNG。ピクセル寸法は参照画像と一致させます。透明部分が再生成されます。
callback_url	string · 任意	タスク結果を受け取る HTTPS webhook。ポーリングの代わりに使えます。

本番利用前に想定しておくべき制限

文字とレイアウトは要確認

文字のレンダリングは改善されていますが、正確な配置、鮮明さ、構造化された構図は依然としてプロンプトどおりにならない場合があります。

大サイズ出力は実験的機能

カスタムサイズは一辺 3840 px まで指定できますが、総ピクセル数が 3,686,400（2560x1440 のピクセル数）を超える出力は現時点では実験的な機能です。

透過背景は Preview

background: "transparent" は利用可能ですが、まだ Preview です — 出力が安定しない場合があります。

複雑なリクエストは時間がかかることも

OpenAI は、複雑なプロンプトの処理に最大 2 分かかる場合があると案内しています。

最新の制限は OpenAI の画像生成ガイドでご確認ください

EvoLink 経由で GPT Image 2 を使う理由

生成前に正確なコストを見積もれる

トークン課金は、GPT Image 2 で最も予算を立てにくい部分です。画像出力トークンは解像度と品質ティアに応じて増え、参照画像 1 枚ごとに入力トークンが加算され、プロンプト自体も計量されます。EvoLink はこれを送信前に提示される見積もりに変えます — 料金計算機と Playground のどちらも、これから送るサイズ・解像度・品質・参照画像の組み合わせそのままの価格を提示します。

これでテストの進め方が変わります。low ティアでプロンプトを反復し、変更のたびに見積もりの動きを確認し、最終レンダリングだけを high に上げる — コストのパターンを月末の請求書で初めて知る必要がなくなります。

OpenAI 定価を項目ごとに下回る

このページの料金セクションでは、画像出力・画像入力・キャッシュ済み入力・テキストというトークン種別ごとに、EvoLink 価格を OpenAI 公式価格と並べて掲載し、各行の現在の節約率を表示します。EvoLink の最安値保証つきです。

この比較はマーケティング上の謳い文句ではなくリアルタイムの SKU 価格から計算されているため、導入するその場で検証でき、差額が効いてくるほどボリュームが増えたときにいつでも再確認できます。

1 ページに 2 つの課金ルート

gpt-image-2 と gpt-image-2-beta を並行して提供しています。前者は 1K/2K/4K、品質ティア、マスク、複数参照画像までフル対応の公式トークン課金ルート、後者はプロンプトの長さや参照画像の数にかかわらず 1K 画像 1 枚が同額の定額ルートです。

実運用では、下書き・プロンプト反復・1K の大量ジョブはコストが完全に予測できる定額ルートに載せ、2K/4K の最終出力、マスク、参照画像の多い編集はトークンルートに残すのが定番です。切り替えは model ID の変更だけで、ベンダー移行ではありません。

1 本の API キーで画像・動画・音声・LLM ルートまで

gpt-image-2 を呼び出すのと同じ API キーで、動画の Seedance、代替画像ルートの Nano Banana 2 と Seedream、さらに LLM カタログまで呼び出せます — 残高も、タスク履歴も、認証経路もひとつです。

画像の仕事でこれが効くのは、パイプラインが静止画で終わることがまれだからです。キーフレームを GPT Image 2 で生成し、Seedance で動かし、ジョブに合うなら別の画像モデルへフォールバックする — プロバイダーごとのアカウント・キー・請求記録を維持する必要はありません。

支払う前に監査できるタスク状態

すべての生成は、送信済み・処理中・完了・失敗を、レスポンスとコンソールのエラー詳細つきで報告します。失敗タスクは課金対象の成功生成として扱われないため、不調なジョブの一括投入が気づかぬうちに請求書へ変わることはありません。

本番システムにとって、これは「リクエストを送った」と「画像が届いた」の差です。タスクをポーリングして最終状態を確認し、数字の説明が必要になったら、コンソールのタスク別記録と支出を突き合わせられます。

GPT Image モデルファミリー

GPT Image 1.5

1 世代前の OpenAI 画像ルート。1024 系の固定サイズ、トークン課金で、本番挙動が安定しています。

見る

EvoLink の他の画像モデル

Nano Banana 2

高品質な生成と柔軟なクリエイティブワークフローに対応する Google の画像モデル。

見る

Nano Banana Pro

より高い忠実度と本番品質の出力を狙う Nano Banana の上位ルート。

見る

Seedream 5.0 Pro

1K/1.5K/2K ティア、マルチ参照編集、レイヤー分解に対応する BytePlus の画像ルート。

見る

Grok Imagine Image 2.0

入力画像の枚数でモードが決まる xAI の画像ルート。1K/2K 出力、1 回あたり最大 10 枚。

見る

よくある質問

GPT Image 2 と ChatGPT Images 2.0 の関係は？

GPT Image 2 は ChatGPT Images 2.0 と同時期にリリースされた、API から利用できる画像モデルで、モデル ID は gpt-image-2 です。ChatGPT は画像生成に推論、ウェブ検索、複数画像のオーケストレーションを組み合わせる場合があるため、生の API モデルがすべての ChatGPT 製品ワークフローと同一とは限りません。

GPT Image 2 と GPT Image 2 Beta の違いは？

EvoLink 上の別々のルートバリアントです。gpt-image-2 はトークン課金の公式ルートで、low/medium/high 品質、1K/2K/4K 解像度、明示的な WxH ピクセル、最大 10 枚の n、インペイントマスクに対応します。gpt-image-2-beta は 1K 出力・1 回の呼び出しにつき 1 枚という EvoLink 独自の固定価格ルートで、OpenAI 公式のモデル ID ではありません。

GPT Image 2 の料金は？

トークン課金です。画像出力トークンが費用の中心で、解像度ティアと品質ティアに応じて増えます。参照画像ごとに画像入力トークンが加算され、プロンプトからテキスト入力トークンが発生します。Playground が送信前に選択した組み合わせで見積もります。固定の 1 枚単価が必要な場合は、GPT Image 2 Beta が 1 回あたり固定課金です。料金計算ツールでも 1 枚あたりのコストを見積もれます。

EvoLink の GPT Image 2 料金は OpenAI と比べてどうですか？

料金セクションでは、現在の EvoLink 料金と OpenAI の定価を比較し、確認時点で利用できる節約幅を表示しています。一律の 1 枚あたり価格の主張に頼らず、料金計算ツールでサイズ・品質・参照画像の組み合わせごとに確認してください。

GPT Image 2 には Image API と Responses API のどちらを使うべきですか？

Image API では、生成や編集に gpt-image-2 を直接指定します。Responses API では、image_generation ツールに対応したメインラインモデルを選び、対話型や多段階のワークフローでは同ツールが画像モデルの選択を担います。EvoLink はモデルへ直接アクセスできる独自の統合ルートを提供しています。

API 統合の前にプレビューできますか？

はい。Playground で出力品質を試し、クレジットを見積もり、リクエスト JSON を確認してからプロダクトに組み込めます。

size と resolution の違いは？

size は形を決めます（auto、15 種類の比率、明示的な WxH ピクセル）。resolution は比率モードでのみピクセル予算を決め、auto や明示ピクセルでは無視されます。

参照画像も課金されますか？

はい。image_urls の各画像が画像入力トークンを追加します。マスクは見積もり時に入力画像 1 枚分として予約され、上流の実際の usage で精算されます。

カスタムピクセルサイズの制限は？

幅と高さは 16 の倍数、総ピクセル数は 655,360〜8,294,400、各辺は 3840 px 以下、アスペクト比は 1:3〜3:1 の範囲に収める必要があります。総ピクセル数が 3,686,400（2560x1440 のピクセル数）を超える出力は、現時点では実験的な機能です。

1 リクエストで複数枚生成できますか？

gpt-image-2 では可能です。n は 1〜10 で、コストは線形に増えます。GPT Image 2 Beta は 1 回の呼び出しにつき 1 枚です。

インペイントマスクの使い方は？

mask_url にはアルファチャンネル付きの PNG を渡し、ピクセル寸法を参照画像と完全に一致させます。透明ピクセルが再生成範囲、不透明ピクセルは保持されます。参照画像なしで送るとマスクは破棄されます。

生成に失敗した場合は？

レスポンスまたはコンソールでタスク状態とエラー詳細を確認してください。失敗タスクは課金対象の成功生成として扱われません。

GPT Image 2 の主な制限は？

複雑なプロンプトは処理に最大 2 分かかることがあります。文字の配置、繰り返し登場するキャラクターの一貫性、精密な構造化構図には依然として試行錯誤が必要な場合があります。

GPT Image 2 ガイド

GPT Image 2 開発者ガイド

リクエスト契約、size と resolution の関係、非同期ポーリング、トークン課金を実数値で解説。

GPT Image 2 と GPT Image 1.5 の比較

2 つのルートで実際に何が変わったのか、本番ではどちらを残すべきか。

API Reference

Select endpoint

Model ID

Endpoints

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/images/generations

Generate Image

Create an image generation task using text prompts. Supports text-to-image and reference-image-assisted generation.

Asynchronous processing mode, use the returned task ID to query status.

Generated image links are valid for 24 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: gpt-image-2

Image generation model name.

Value	Description
gpt-image-2	Official GPT Image 2 — token-based billing

Examplegpt-image-2

promptstringRequired

Prompt describing the image to be generated or how to edit the reference image.

Notes

Max 32,000 characters (counted by Unicode code points — works for CJK and other languages)

ExampleA beautiful colorful sunset over the ocean

sizestringOptionalDefault: auto

Aspect ratio or explicit pixel dimensions (WxH).

Value	Description
auto	Default — let the model decide
1:1 / 1:2 / 2:1 / 1:3 / 3:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 / 9:21	Aspect ratio — pixel size decided together with the resolution tier
1024x1024 (or any WxH)	Explicit pixels — multiples of 16, pixel budget 655K~8.29M, edges ≤3840, aspect ≤3:1

Notes

When size is explicit WxH pixels, the resolution parameter is ignored.
In auto mode the model decides the final size; resolution has no effect.
Combinations that exceed the 8.29 MP pixel budget are proportionally scaled down (e.g. 4K 1:1 → 2880×2880).

Exampleauto

resolutionstringOptionalDefault: 1K

Resolution tier shortcut. Only effective when size is a ratio; ignored for explicit pixels and auto.

Value	Description
1K	Pixel budget ≈ 1024² = 1.05MP (1:1 → 1024×1024, 16:9 → 1360×768)
2K	Pixel budget ≈ 2048² = 4.19MP (1:1 → 2048×2048, 16:9 → 2736×1536)
4K	Pixel budget = 8.29MP / MaxPixels (1:1 → 2880×2880, 16:9 → 3840×2160 UHD)

Example2K

qualitystringOptionalDefault: medium

Rendering quality / reasoning depth. Directly drives output token count (tile base 16/48/96 for low/medium/high).

Value	Description
low	Tile base 16 — fastest, ~0.11× cost vs medium
medium	Tile base 48 — balanced (default)
high	Tile base 96 — highest fidelity, ~4× cost vs medium

Examplemedium

backgroundstringOptionalDefault: opaque

Alpha channel of the output image. Transparent is a Preview feature and results may be unstable.

Value	Description
opaque	Flat background, no alpha channel (default)
transparent	Keeps an alpha channel (Preview, may be unstable)

Exampleopaque

nintegerOptionalDefault: 1

Number of images to generate (1-10). Each image is billed independently; text input tokens scale linearly with n.

Example1

image_urlsarrayOptional

Reference image URL list for image-to-image and image editing features.

Notes

1–16 images per request
Each image ≤ 50 MB
Supported formats: .jpeg, .jpg, .png, .webp
URLs must be directly accessible by the server, or URLs that trigger direct download (typically URLs ending with image extensions like .png, .jpg)
Reference images themselves consume additional image-input tokens in edit / image-to-image mode

Examplehttps://example.com/image1.png

mask_urlstringOptional

Inpainting mask image URL — marks the region of the reference image to regenerate. Only valid in image edit mode (combined with image_urls); ignored in pure text-to-image.

Notes

Only PNG with an alpha channel is accepted — transparent pixels (alpha < 255) mark areas to regenerate, opaque pixels are preserved
Mask dimensions must EXACTLY match the reference image dimensions (width × height in pixels)
Requires at least one image in image_urls — mask alone has no effect
Single mask per request

Examplehttps://example.com/mask.png

callback_urlstringOptional

HTTPS callback address after task completion.

Notes

Triggered on completion, failure, or cancellation
Sent after billing confirmation
HTTPS only, no internal IPs
Max length: 2048 chars
Timeout: 10s, Max 3 retries

Examplehttps://your-domain.com/webhooks/image-task-completed

Request Example

{
  "model": "gpt-image-2",
  "prompt": "A beautiful colorful sunset over the ocean",
  "size": "auto",
  "resolution": "1K",
  "quality": "medium",
  "background": "opaque",
  "n": 1,
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "mask_url": "https://example.com/mask.png"
}

Response Example

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_token",
    "credits_reserved": 1.98,
    "user_group": "default"
  }
}