メインコンテンツへスキップ
POST
Text-to-Image: generate at an explicit size from a text prompt
右側のインタラクティブなPlaygroundでは、オンラインで直接テストが行えます。AuthorizationフィールドにAPI Key(形式:Bearer sk-xxx)を入力し、promptとsizeを設定して、送信をクリックしてください。
適用範囲: このページはテキストからの画像生成を対象としています。画像のアップロードは不要で、promptとsizeを入力するだけです。既存の画像を編集または合成する場合は、画像編集エンドポイントをご利用ください。gpt-image-2-allとの違い: 呼び出し構造は同一で、sizeフィールドが1つ追加されているだけです。サイズを固定する必要がなく、最速の出力を希望される場合は、代わりにgpt-image-2-allをご利用ください。
🖥️ ブラウザPlaygroundの制限事項このエンドポイントはデフォルトでbase64文字列(b64_json)を返します。これは数MBになる場合があるため、ブラウザのPlaygroundに请求时发生错误: unable to complete requestと表示されることがあります — リクエスト自体は実際には成功しています。ブラウザ側でこれほど長いbase64文字列をレンダリングできないだけです。推奨されるワークフロー: 以下のコードサンプルをコピーしてローカルで実行してください — 画像を自動的にデコードしてファイルに保存します。
すべての画像APIは同期的です — ポーリング用のタスクIDは存在せず、クライアントが切断された場合、リクエストに対して課金されたままで結果は失われます。このモデルには十分なタイムアウトを設定してください。詳細は画像APIの基本とベストプラクティスをご覧ください。
⚠️ 主要パラメータの注意事項
  • size: モデルに選択させる場合はautoを渡し(vipは指定されたpromptに対して比較的固定/安定したサイズに収束する傾向があります)、厳密に固定したい場合はサポートされている30種類のサイズ(10種類のアスペクト比 × 1K Fast / 2K Recommended / 4K Detail — 概要ページの全サイズ一覧表を参照)から1つ選択してください。小文字のアスキー文字xを使用してください(例:2048x1360、3840x2160)。決して×や大文字のXは使用しないでください。
  • quality: 任意であり、テストにおいて有効です(チャンネルの挙動であり確約ではありません — 実際のレスポンスをご確認ください)。2.5モデル(gpt-image-2.5-vip = gpt-image-2.5-sunburst-vip、gpt-image-2.5-flare-vip)は、auto / low / medium / high / xhigh / maxの6つのティアすべてを受け付けます。gpt-image-2-vipはhighまでとなり、xhigh / maxは拒否されます。同名のティアでも同等ではありません。2.5のhighはgpt-image-2-vipのmediumにのみ一致し、2.5のmaxはそのhighに一致します。画像1枚あたり一律$0.03という価格はティアによって変わりませんが、上位ティアほど時間がかかります。
  • n: ❌ 拒否されます — 1回の呼び出しにつき画像1枚です。n=3を送信すると3倍課金されますが、返される画像は1枚のままです。 このフィールドは除外してください。
  • aspect_ratio: ❌ 拒否されます — アスペクト比はsizeによって決定されます。
  • response_format: 省略するとbase64が返されます(プレフィックスなしの生データ、2026-07検証済み)。画像URLを取得するには"url"を渡してください。URL出力に依存するビジネスでは、base64へのフォールバックなしで確実にURLを出力するために、tokenをimage2_OSSグループに切り替えてください。

コード例

Python

4Kディテール階層の例(壁紙/印刷):

cURL

Node.js

OpenAI SDK(Python、推奨)

パラメータ

サイズ早見表 — ほとんどのケースをカバーします:
  • Eコマースのメインビジュアル: 2048x1360 (3:2 2K) / 2048x2048 (1:1 2K)
  • 縦型ポスター: 1536x2048 (3:4 2K) / 2480x3312 (3:4 4K)
  • 動画サムネイル: 2048x1152 (16:9 2K) / 3840x2160 (16:9 4K)
  • ストーリー / スマートフォン用壁紙: 1152x2048 (9:16 2K) / 2160x3840 (9:16 4K)
30種類すべてのサイズ表: 概要ページ。

レスポンス形式

デフォルトでは base64 を返します(data[0].b64_json、プレフィックスなしの raw base64、2026-07 に検証済み)。代わりに 画像 URL を取得するには、response_format: "url" を明示的に指定してください。URL 出力に依存するビジネスは、base64 フォールバックなしで安定した URL 出力を得るために、token のグループを image2_OSS に切り替えてください。data[0] は url または b64_json のいずれかを返します — 両方が返ることはありません。 b64_json モード(デフォルト):
url モード(response_format: "url" を明示的に指定してください。URL に依存する場合は image2_OSS グループを使用してください — R2 CDN によりグローバルに高速化されています):
互換性メモ: 2026年7月に検証済み — b64_json フィールドは data: プレフィックスなしの raw base64 です。ファイルを書き出すにはデコードするか、描画前にご自身でプレフィックスを付けてください。以前のバージョンではプレフィックスが含まれていたため、両方の形式に対応できるよう、最初に必ず startsWith('data:') チェックを実行してください。

関連リソース

モデル概要(全サイズ表)

30サイズの完全な表、料金、技術仕様

画像編集 API

/v1/images/edits 複数画像の融合と編集

姉妹モデル gpt-image-2-all

サイズを固定する必要がない場合は同じ呼び出し形式で、より高速に出力できます(約30~60秒)

承認

Authorization
string
header
必須

API Key from the API易 Console

ボディ

application/json
model
enum<string>
デフォルト:gpt-image-2.5-vip
必須

Model name: gpt-image-2.5-vip (= sunburst-vip) / gpt-image-2.5-flare-vip / gpt-image-2-vip, same price and call format

利用可能なオプション:
gpt-image-2.5-vip,
gpt-image-2.5-sunburst-vip,
gpt-image-2.5-flare-vip,
gpt-image-2-vip
prompt
string
必須

Prompt — describe content, style, lighting, etc.

例:

"Cinematic landscape, old lighthouse by the sea at dusk, photorealistic"

quality
enum<string>

Quality tier (works in testing; channel behavior, not a commitment — go by the actual response). All six tiers on the 2.5 models (gpt-image-2.5-vip / gpt-image-2.5-sunburst-vip / gpt-image-2.5-flare-vip); gpt-image-2-vip stops at high and rejects xhigh / max. Same-named tiers are not equal: 2.5 high only equals gpt-image-2-vip medium, and 2.5 max equals its high. The flat $0.03 does not change with the tier, but latency rises with it.

利用可能なオプション:
auto,
low,
medium,
high,
xhigh,
max
例:

"high"

size
enum<string>

Output size. Pass auto to let the model decide (vip tends to converge on a relatively fixed size for a given prompt), or pick one of the 30 supported sizes (10 ratios × 1K Fast / 2K Recommended / 4K Detail) to lock it strictly. Format: WIDTHxHEIGHT with lowercase ASCII x, e.g., 2048x1360, 3840x2160. Flat $0.03/image across all tiers.

利用可能なオプション:
auto,
1280x1280,
848x1280,
1280x848,
960x1280,
1280x960,
1024x1280,
1280x1024,
720x1280,
1280x720,
1280x544,
2048x2048,
1360x2048,
2048x1360,
1536x2048,
2048x1536,
1632x2048,
2048x1632,
1152x2048,
2048x1152,
2048x864,
2880x2880,
2336x3520,
3520x2336,
2480x3312,
3312x2480,
2560x3216,
3216x2560,
2160x3840,
3840x2160,
3840x1632
例:

"2048x1152"

レスポンス

Image successfully generated. Defaults to base64 in data[0].b64_json — url is not returned in the same response.

Image generation response. Returns base64 by default (data[0].b64_json); to get a url, switch to the image2_OSS group with response_format=url. data[0] returns either url or b64_json, never both.

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics