Skip to main content
POST
Text-to-Image: generate at an explicit size from a text prompt
右側のインタラクティブなプレイグラウンドでは、オンラインで直接テストできます。API Key を 認証 フィールドに入力し(形式: Bearer sk-xxx)、promptsize を設定してから、送信をクリックしてください。
対象範囲: このページは text-to-image 生成 用です。prompt を入力するだけで size できます。画像のアップロードは不要です。既存画像の編集や融合には、画像編集エンドポイントを使用してください。gpt-image-2-all との違い: 呼び出し構造は同じで、追加されるのは size フィールド 1 つだけです。サイズを固定する必要がなく、最速の出力が欲しい場合は、代わりに gpt-image-2-all を使用してください。
🖥️ ブラウザーの Playground の制限このエンドポイントはデフォルトで base64 文字列(b64_json)を返します。これは数 MB になることもあるため、ブラウザーの Playground では 请求时发生错误: unable to complete request が表示される場合があります。実際にはリクエストは成功しています。ブラウザーでは、これほど長い base64 文字列をレンダリングできないだけです。推奨ワークフロー: 以下のコードサンプルをコピーしてローカルで実行してください。画像をデコードして、ファイルに自動で保存します。
すべての画像 API は同期式です。ポーリングする task ID はなく、クライアントが切断されると、リクエストは課金されたまま結果が失われます。このモデルでは十分に長いタイムアウトを設定してください。詳細は Image API の基礎とベストプラクティス を参照してください。
⚠️ 重要なパラメータの注意点
  • size: auto を指定すると、モデルに選択を任せられます(vip は、同じ prompt では比較的 固定/安定 したサイズに収束する傾向があります)。厳密に固定したい場合は、対応する 30 種類のサイズ(10 比率 × 1K 高速 / 2K 推奨 / 4K 詳細 — 概要ページの完全なサイズ表 を参照)から 1 つを選んでください。小文字の ASCII x を使用し、たとえば 2048x13603840x2160 のようにします。× や大文字の X は使用しないでください。
  • quality: ❌ 受け付け不可 — 指定しないでください
  • 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 Detail ティアの例(壁紙 / 印刷):

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-vip
必須

Model name, fixed to gpt-image-2-vip

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

Prompt — describe content, style, lighting, etc.

:

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

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_jsonurl 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