gpt-image-2.5-sunburst API

正確なモデル ID gpt-image-2.5-sunburst を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力gpt-image-2.5-sunburstPOST /v1/images/generations

パラメータ: size=1536x1024n=1

プロンプト： The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

このサンプルを作成したリクエスト

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/images/generations です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

画像の生成

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

リクエストメモ

GPT Image 2.5 Sunburst は、より忠実度の高い、より高度なコントロールの作成と編集をターゲットとしています。 images[]、image[]、mask、xhigh/max、および両方の操作の出力コントロールを保持します。

リクエストパラメータ

GPT Image 2.5 は OpenAI 互換の画像 API を使用します。生成には JSON を使用します。編集では、JSON 画像参照またはマルチパート ファイルを受け入れます。応答は Base64 画像データを data[].b64_json で返します。

フィールド	必須	注意事項
model	はい	gpt-image-2.5-sunburst
prompt	はい	生成または編集命令、1 ～ 32,000 文字
images[]	条件付き	JSON 編集の場合、最大 16 個の file_id または image_url オブジェクト
images[].file_id	条件付き	アップロードファイルAPI ID
images[].image_url	条件付き	画像 URL または Base64 データ URL。データ URL は 20,971,520 文字に制限されています
image	条件付き	1 つのマルチパート ソース ファイル。複数のファイルには image[] を使用します
image[]	条件付き	マルチパート編集の場合、最大 16 個のソース ファイル
mask	いいえ	最初のソース形式/サイズに一致し、50 MB 未満のアルファ マスク
size	いいえ	auto またはカスタム WIDTHxHEIGHT; 16 ピクセル倍数、アスペクト比 1:3 ～ 3:1、最大エッジ 3,840 ピクセル、総ピクセル数 655,360 ～ 8,294,400
quality	いいえ	low / medium / high / xhigh / max / auto;デフォルトauto
background	いいえ	auto / opaque / transparent;透明な背景には PNG または WebP 出力が必要です
output_format	いいえ	png / jpeg / webp;デフォルト png
output_compression	いいえ	JPEG/WebP の場合は 0 ～ 100、デフォルトは 100。 PNG の場合は無視されます
moderation	いいえ	auto / low;デフォルト auto
n	いいえ	1 ～ 10 出力。デフォルト 1

応答および入力制限

GPT Image 2.5 フレアとサンバーストは最大 16 個の編集入力をサポートします。 JSON 編集では、images[] と file_id または image_url を使用します。マルチパート編集では image/image[] を使用し、各ソース画像とマスクは 50 MB 未満です。プロンプトは 1 ～ 32,000 文字です。品質はlow/medium/high/xhigh/max/autoをサポートします。サイズ ルールは、16 ピクセルの倍数、アスペクト比 1:3 ～ 3:1、最大エッジ 3,840 ピクセル、合計ピクセル 655,360 ～ 8,294,400 です。透明な背景には PNG または WebP が必要です。圧縮は JPEG/WebP にのみ適用され、PNG では無視されます。 2560x1440 を超える解像度は実験的なものです。 data[].b64_json を読んでください。 DALL・E-only response_formatは送信しないでください。 Flare は、日常の生成と編集のための高速で高品質なデフォルトです。サンバーストは、より忠実度が高く、よりコントロール性の高い作業に適しています。

画像編集

GPT Image 2.5 は、/v1/images/edits を介した JSON 画像参照とマルチパート ファイルのアップロードをサポートしています。 JSON は、file_id または image_url を使用して最大 16 個のオブジェクトを受け入れます。マルチパートは最大 16 個のソース ファイルを受け入れます。 1 つのリクエスト内で images と image/image[] を混在させないでください。

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

応答形状

生成・編集結果をdata[]から読み込みます。 GPT Image 2.5 は Base64 画像データを返します。応答を URL 出力として扱わないでください。

フィールド	注意事項
created	Unix タイムスタンプとしての作成時間 (秒単位)
data	画像生成・編集結果
data[].b64_json	Base64でエンコードされた画像データ
background	最終背景モード: opaque または transparent
output_format	返される画像形式：png、jpeg、webp
quality	使用される品質レベル
size	WIDTHxHEIGHT としての最終寸法

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。選択したモデル コントラクトによって定義された応答フィールドとエラー メッセージを使用します。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

このモデルはトークンベースの課金を使用します。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。