gpt-image-2.5-flare API

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

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

パラメータ: size=1536x1024quality=mediumn=1

プロンプト： Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

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

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

認証とエンドポイント

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-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

リクエストメモ

GPT Image 2.5 Flare は、日常の生成と編集のための高速で高品質なデフォルトです。 images[]、image[]、mask、および完全な出力コントロールを保持します。

リクエストパラメータ

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

フィールド	必須	注意事項
model	はい	gpt-image-2.5-flare
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-flare",
    "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": "high", "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-flare" \
  -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=high" \
  -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 のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。