メインコンテンツへスキップ
POST

Authorizations

Authorization
string
必須
すべてのエンドポイントは Bearer Token による認証が必要ですAPI キーの取得:API キー管理ページ にアクセスして API キーを取得してください使用時はリクエストヘッダーに以下を追加:

Body

model
string
デフォルト:"gpt-image-2-official"
必須
画像生成モデル名gpt-image-2-official に固定(OpenAI 公式 gpt-image-2 モデル)
prompt
string
必須
画像生成のテキスト記述
  • 日本語・英語・中国語をサポート、詳細な記述を推奨
  • 送信前にプラットフォームのセンシティブワード / セーフティレビューを通過します。違反内容は即座にエラーを返します
size
string
デフォルト:"1:1"
画像の比率対外的には比率値を使用し、システム内部で resolution に基づいて具体的なピクセルに自動マッピングされます。以下の比率をサポート、さらに auto を指定するとサーバー側で適切な比率を自動選択します:
  • auto - 自動(prompt / 参照画像に基づきサーバー側が比率を選択)
  • 1:1 - 正方形(デフォルト、SNS アバター / ロゴ)
  • 3:2 - 横構図(一眼レフでよく使われる比率)
  • 2:3 - 縦構図(縦長ポスター)
  • 4:3 - 横構図(クラシックモニター / スライド)
  • 3:4 - 縦構図
  • 5:4 - 横構図
  • 4:5 - 縦構図(Instagram 縦型投稿)
  • 16:9 - 横構図(ワイド動画サムネイル)
  • 9:16 - 縦構図(スマホフルスクリーン / ショート動画カバー)
  • 2:1 - 横構図(Web バナー)
  • 1:2 - 縦構図
  • 3:1 - 横構図(ウルトラワイドバナー)
  • 1:3 - 縦構図(超縦長ポスター)
  • 21:9 - 横構図(映画ウルトラワイド)
  • 9:21 - 縦構図
1881x836 / 887x1774 のようなピクセルサイズも直接指定できます。
sizeauto を指定した場合、デフォルトの比率は 1:1 です。
resolution
string
デフォルト:"1k"
解像度ティア(新規フィールド実際の出力解像度を制御します。
  • 1k - 1024 ベースライン、日常利用でコスト効率が良い(デフォルト)
  • 2k - 2048 ベースライン、ポスター / 高精細用途に適する
  • 4k - 3840 ベースライン、下記マッピング表の 15 種の比率をサポート
4K は下記マッピング表の 15 種の比率をサポートします。表内のピクセルサイズを size で直接指定することもできます。
quality
string
デフォルト:"auto"
画像品質
  • auto - 自動(デフォルト、通常 low に相当)
  • low - 高速で低コスト、ラフスケッチで十分
  • medium - バランス型
  • high - 最高精度(4K + high は 120 秒以上かかる場合あり)
background
string
デフォルト:"auto"
背景モード
  • auto - 自動(デフォルト)
  • opaque - 不透明
  • transparent - ⚠️ gpt-image-2-official は透過背景をサポートしません。指定してもシステムは静かに auto にダウングレードします
moderation
string
デフォルト:"auto"
モデレーション強度
  • auto - デフォルトモデレーション強度
  • low - より緩やかなモデレーション
output_format
string
デフォルト:"png"
出力フォーマット
  • png - デフォルト
  • jpeg - ファイルサイズが小さい
  • webp - モダンブラウザ向け最適
output_compression
integer
出力圧縮レベル、範囲 0-100
  • jpeg / webp のみ有効
n
integer
デフォルト:"1"
生成する画像の枚数範囲:1 ~ 4
必ず数値(例:1)を入力してください。引用符で囲まないでください
image_urls
array
参照画像 URL 配列
mask_url
string
マスク画像 URL、インペインティング用
  • image_urls と併用する必要があります
  1. マスク画像をアップロードする前に、Alpha チャンネルが「はい」であることを確認してください。
  2. マスク画像のサイズは 最初の参照画像と一致 する必要があります。

サイズ × 解像度マッピング表

size × resolution → OpenAI 実ピクセル(15 比率 × 3 ティア):
備考:一部のサイズは 16 の倍数とピクセル上限に基づいて近似マッピングされます。例:3:2 / 2:3 @ 2K は 2048×1360、21:9 @ 4K は 3840×1648 です。実際のピクセルは表の値を基準にしてください。

使用シナリオ例

テキストから画像(最小リクエスト)
2K 高精細ポスター
4K 壁紙
画像から画像(複数参照画像の融合)
インペインティング(mask)
複数枚生成(n > 1)
ピクセル文字列の直接指定(上級利用)

Response

code
integer
レスポンスステータスコード
data
array
レスポンスデータ配列

タスク結果のクエリ

提出成功後に task_id が返されます。GET /v1/tasks/{task_id} でタスク状態をポーリングしてください。詳細は タスククエリ API を参照。

成功レスポンス例

usage フィールドはこのリクエストの課金対象トークン使用量を示します: 画像生成では出力の大半が画像トークンのため、output_tokens_details.image_tokens は通常 output_tokens と等しくなります。上の例では total_tokens = 22 + 196 = 218 です。 タスクステータスフロー:submittedin_progresscompleted / failed 画像の取得:data.result.images[0].url[0]