メインコンテンツへスキップ
POST
Text-to-Image: generate image from text prompt
右側のインタラクティブなプレイグラウンドでは、ライブテストを実行できます。Authorization に API キー(形式: Bearer sk-xxx)を入力し、プロンプトを入力して、サイズ / 品質を選択して送信します。
ユースケース: このページは「テキストから画像へ」用です。プロンプトを入力するだけでよく、画像のアップロードは必要ありません。参照画像の編集、複数画像の融合、またはマスクによるインペインティングには、画像編集エンドポイントを使用してください。
🖥️ ブラウザプレイグラウンドの制限(重要)このエンドポイントは、レスポンスで生の base64 文字列(通常は数 MB)を返します。ブラウザのレンダリング制限により、右側のプレイグラウンドではレスポンスの到着後に请求时发生错误: unable to complete requestと表示される場合があります。リクエストは実際には成功しています。ブラウザでは、このように長い base64 文字列をレンダリングできないだけです。推奨ワークフロー(初心者向け):
  • 以下の Python / Node.js / cURL サンプルをコピーして、ローカルで実行してください。コードがレスポンスを自動的にbase64.b64decodeし、画像をファイルに書き込みます。
  • ブラウザ内のプレイグラウンドを使用する必要がある場合は、sizeを最小ティア(例: 1024x1024)に設定し、qualityをlowに設定してレスポンスを小さくしてください。
すべての画像 API は同期型です。ポーリングするタスク ID はなく、クライアントが切断すると、リクエストの課金が継続している間でも結果は失われます。このモデルには十分に長いタイムアウトを設定してください。画像 API の基本とベストプラクティスを参照してください。
⚠️ サポートされていないパラメータ
  • input_fidelity — 3 つのモデルすべてで高忠実度が強制されます。これを渡すと 400 が返されます(2026-09-09 に 2.5 で検証: does not support the 'input_fidelity' parameter)。1.5 から移行する場合は、この行を削除するだけです。
2560×1440を超える出力は、引き続き実験的なものです。本番環境では、プリセットの 2048x1152 / 2048x2048 / 3840x2160を優先してください。

コード例

Python(OpenAI SDK)

Python(requests を直接使用)

cURL

Node.js(ネイティブ fetch)

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

パラメータリファレンス

quality に従来の DALL·E の値 standard / hd を渡さないでください。 公式の 6 つの enum 値 low / medium / high / xhigh / max / auto のみが受け付けられます(xhigh / max は 2 つの 2.5 モデルのみ対応)。従来の値はバックエンドチャネルによって挙動が異なります。400(invalid_value)で即座に失敗する場合もあれば、通知なしに無視されて auto でリクエストが実行される場合もあります(予期しないコストが発生します)。常に公式の値のいずれかを明示的に渡してください。
詳細な制約、許可される値、およびサンプルは右側の 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.5-flare
必須

Model name. gpt-image-2.5-flare (speed-first) / gpt-image-2.5-sunburst (quality- and editing-first) / gpt-image-2 (previous generation) share the same price and parameters; pin a dated snapshot in production

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

Prompt text, up to 32,000 characters (provider limit, counted in characters). Supports both Chinese and English. Place scene description at the front for better adherence.

Maximum string length: 32000
例:

"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), xhigh / max (new in 2.5: higher quality and cost, rejected by gpt-image-2), auto (default)

利用可能なオプション:
auto,
low,
medium,
high,
xhigh,
max
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) / opaque / transparent. transparent requires png or webp (jpeg has no alpha channel)

利用可能なオプション:
auto,
opaque,
transparent
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)