Skip to main content
POST

認証とリクエストヘッダー

string
必須
生成およびタスク照会エンドポイントは、プラットフォームの API Key による Bearer Token 認証を使用します。API Key 管理ページでキーを取得してください。
タスクの照会には、同じプラットフォームユーザーに属する API Key を使用してください。
string
必須
送信時は application/json を使用します。テキストからの生成と参照画像を使った生成のどちらも、JSON リクエストボディを送信します。

バージョンの選択

リクエストパラメータ

string
必須
固定値:gpt-image-2.5-ext
string
デフォルト:"flare"
モデルのバージョン。flaresunburst から選択します。
string
必須
画像の生成または編集に使用するプロンプト。前後の空白を除去した後に空であってはなりません。参照画像を使う場合は、保持したい内容と変更したい内容を記述できます。
string
デフォルト:"1K"
出力解像度の区分。1K2K4K から選択します。
string
デフォルト:"auto"
出力画像のアスペクト比。auto または次の 10 種類から選択します。1:116:99:164:33:43:22:35:44:521:9
integer
デフォルト:"1"
1 回のリクエストで生成する画像数。14 の整数で指定します。
string[]
最大 16 枚の参照画像の配列。参照画像を省略するとテキストから生成し、指定すると参照画像を使って生成します。参照画像に追加料金はかかりません。対応する入力形式:
  • アクセス可能な画像 URL
  • Data URL: data:image/...;base64,...

使用例

以下は POST /v1/images/generations の JSON リクエストボディです。認証と推奨ヘッダーは上記のとおりです。参照画像の例示 URL は、実際にアクセス可能な画像 URL に置き換えてください。

テキストから画像を生成

Sunburst で参照画像から生成

複数の参照画像と複数枚の出力

自動アスペクト比と 4K 解像度

タスク結果の照会

タスク ID を使ってタスク照会エンドポイントを呼び出します。

タスク成功時

以下のタスク ID、時刻、URL、金額はレスポンス構造を示す例です。実際のタスクや料金を表すものではありません。

レスポンス

integer
レスポンスのステータスコード。統一形式で送信が成功した場合は 200 です。
string
トラブルシューティングに使用する、このリクエストの識別子。
object
受理された非同期タスク。