Skip to main content
POST
Text-to-Image: generate image from text prompt
右側のインタラクティブな Playground でライブテストできます。Authorization に API Key を入力し(形式: Bearer sk-xxx)、prompt を入力して、サイズ / 品質を選び、送信してください。
用途: このページは「text-to-image」用です。prompt を入力するだけで、画像のアップロードは不要です。参照画像編集、マルチ画像融合、またはマスクのインペインティングには、Image Edit エンドポイント を使用してください。
🖥️ Browser Playground の制限(重要)このエンドポイントは、レスポンスとして 生の base64 string(通常は数 MB)を返します。ブラウザのレンダリング制限により、右側の Playground ではレスポンス到着後に 请求时发生错误: unable to complete request が表示されることがありますが、リクエスト自体は成功しています。単に、ブラウザがこれほど長い base64 string をレンダリングできないだけです。推奨ワークフロー(初心者向け):
  • 下の Python / Node.js / cURL サンプルをコピーして、ローカルで実行してください。コードはレスポンスを自動で base64.b64decode し、画像をファイルに書き込みます
  • ブラウザ内の Playground を使う必要がある場合は、size を最小の段階(例: 1024x1024)にし、qualitylow に設定して、レスポンスを小さくしてください。
すべての image APIs は 同期型 です。ポーリングする task ID はなく、クライアントが切断されると、リクエストが課金されたまま結果は失われます。このモデルでは余裕のある timeout を設定してください。詳細は Image API の基本とベストプラクティス をご覧ください。
⚠️ 未対応のパラメータ
  • input_fidelitygpt-image-2 は高精細を強制します。これを渡すと 400 が返ります。1.5 から移行する場合は、その行を削除してください。
  • background: "transparent" — 透明背景はサポートされていません。透過が必要な場合は opaque を使うか、後処理してください。
2560×1440 を超える出力は引き続き実験的です。本番環境では、プリセットの 2048x1152 / 2048x2048 / 3840x2160 を優先してください。

コード例

Python (OpenAI SDK)

Python (Raw requests)

cURL

Node.js (Native fetch)

ブラウザ JavaScript (直接レンダリング)

パラメータ参照

旧 DALL·E の値 standard / hdquality に渡さないでください。受け付けられるのは 4 つの公式 enum 値 low / medium / high / auto だけです。旧値はバックエンドチャネル間で挙動が一貫しません。場合によっては 400(invalid_value)ですぐに失敗し、また別の場合には黙って無視され、リクエストは auto で実行されます(コストが予測不能になります)。必ず 4 つの公式値のいずれかを明示的に指定してください。
詳細な制約、許可される値、例は右側の Playground で確認できます。すべての enum フィールドはドロップダウン選択に対応しています。

レスポンス形式

⚠️ b64_json は生の base64 です, data:image/...;base64, なしで出力されます。クライアントは次のようにする必要があります:
  • ファイルに書き込む: base64.b64decode(b64_str) → ディスクに書き込む
  • ブラウザーで表示する: data:image/png;base64, を手動で先頭に付与する
2026年7月時点では、gpt-image-2-all / gpt-image-2-vip も生の base64 を返しますが、以前のバージョンではプレフィックスが含まれていました。モデルをまたいでコードを共有する場合は、常にまず startsWith('data:') を確認してください。
usage フィールドは、この呼び出しに対する実際の課金対象 token を反映します。input_tokens_details / output_tokens_details では、テキストと画像の token を個別に分けて表示します(プレーンな text-to-image では image_tokens は常に 0 です)。フィールドの完全なリファレンスとセルフサービスの料金計算式については、概要ページの各呼び出しの実際の token 数を確認する方法を参照してください。

承認

Authorization
string
header
必須

API Key obtained from APIYI Console

ボディ

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

Model name, fixed as gpt-image-2

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

Prompt text. Supports both Chinese and English. Place scene description at the front for better adherence.

:

"Cyberpunk city at night, neon sign closeup, cinematic frame"

size
string
デフォルト:auto

Output size. Presets: 1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 2048x1152 / 3840x2160 / 2160x3840. Also accepts any valid custom size (max edge ≤ 3840, both multiples of 16, ratio ≤ 3:1, total pixels 0.65–8.3MP).

:

"2048x1152"

quality
enum<string>
デフォルト:auto

Quality tier. low (sketches/batch), medium (daily), high (final/fine text), auto (default)

利用可能なオプション:
auto,
low,
medium,
high
output_format
enum<string>
デフォルト:png

Output format

利用可能なオプション:
png,
jpeg,
webp
output_compression
integer

Output compression (0–100), only effective for jpeg/webp

必須範囲: 0 <= x <= 100
:

85

background
enum<string>
デフォルト:auto

Background mode. auto (default) or opaque. Not supported: transparent

利用可能なオプション:
auto,
opaque
moderation
enum<string>
デフォルト:auto

Moderation strength. auto (default) or low

利用可能なオプション:
auto,
low
n
enum<integer>
デフォルト:1

Number of images. This model only supports 1

利用可能なオプション:
1

レスポンス

Image generated successfully

created
integer

Unix timestamp

:

1776832476

data
object[]

Generation results (this model returns 1 image per call)

usage
object

Token usage for this call (used for token-based billing)