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

コード例

Python (OpenAI SDK)

Python (Raw requests)

cURL

Node.js (Native fetch)

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

パラメータリファレンス

quality に legacy の DALL·E 値 standard / hd を渡さないでください。 受け付けられるのは、4 つの公式 enum 値 low / medium / high / auto のみです。legacy の値はバックエンドチャネル間で挙動が一貫せず、すぐに 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)