メインコンテンツへスキップ
POST
モデル名互換のお知らせ:本エンドポイントはエイリアス gpt-image-2-ext にも対応しており、gpt-image-2 と同等です。両者は互換的に使用でき、効果は同一です。

Authorizations

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

Body

model
string
デフォルト:"gpt-image-2"
必須
画像生成モデル名gpt-image-2 に固定(エイリアス gpt-image-2-ext に対応)
旧バージョンの呼び出しとの互換性のため、エイリアス gpt-image-2-extgpt-image-2 に対応)は引き続き正常に使用できます。
prompt
string
必須
画像生成のテキスト記述
  • 日本語・英語・中国語をサポート、詳細な記述を推奨
  • 送信前にプラットフォームのセンシティブワード / セーフティレビューを通過します。違反内容は即座にエラーを返します
n
integer
デフォルト:"1"
生成する画像の枚数範囲:1 - 10
必ず数値(例:1)を入力してください。引用符で囲まないでください
size
string
デフォルト:"1:1"
画像生成の比率以下の比率をサポート、auto を渡すとサーバー側で適切な比率を自動選択します:1881x836 / 887x1774 のようなピクセルサイズも直接指定できます。
sizeauto を指定した場合、デフォルトの比率は 1:1 です。
resolution
string
デフォルト:"1k"
出力解像度の段階選択肢:1k / 2k / 4ksize × resolution → 実際のピクセル対応:
4K は上記 15 種類の比率をサポートします。表内のピクセルサイズを size で直接指定することもできます。
image_urls
array
参照画像配列(OpenAI 標準フィールド)。渡すと画像から画像モードに切り替わります
その他の OpenAI 標準フィールド(response_formatstyle など)は現在サポートされておらず、無視されます。タスク結果は url のみを返します。base64 が必要な場合はご自身でダウンロードして変換してください。
official_fallback
boolean
デフォルト:"false"
公式チャネルをフォールバックとして使用するかどうか
  • false:使用しない(デフォルト)
  • true:公式チャネルを使用

使用シナリオ例

テキストから画像(最小リクエスト)
テキストから画像(比率指定 + 2K)
テキストから画像(4K 出力)
テキストから画像(複数枚)
画像から画像(参照 = URL)
画像から画像(参照 = base64)
画像から画像(複数参照融合、URL + base64 混在)

Response

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

タスク結果のクエリ

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

成功レスポンス例

画像の取得:data.result.images[0].url[0]

タスクステータス