画像編集・複数画像の合成
1 枚または複数の画像をアップロードし、プロンプトで編集・合成します。
コードを書かない場合は、手持ちのツールで画像生成を参照してください。
始める前に
https://api.ofox.ai/v1openai/gpt-image-2.5-sunburstコード例では flare を使用していますが、編集には sunburst を推奨しますpip install openai画像を編集する
以下のコード例はすべてそのまま実行して動作を確認しています。結果はカレントディレクトリに output.png として保存されます。
cURL
curl -s https://api.ofox.ai/v1/images/edits \
-H "Authorization: Bearer YOUR_OFOX_API_KEY" \
-F "model=openai/gpt-image-2.5-flare" \
-F "image=@input.png" \
-F "prompt=背景を木目のテーブルに置き換え、被写体はそのままにする" \
-F "quality=low" \
-o response.json
jq -r '.data[0].b64_json' response.json | base64 --decode > output.pngsize を省略すると、出力サイズはモデルが決定するため、元の画像と異なる場合があります。元のサイズを維持したい場合は、size=1024x1024 のように明示的に指定してください。
プロンプトの書き方
何を変えるかと、何をそのまま残すかの 2 点を明確に書いてください。
複数の画像を使う場合は、アップロード順に「1 枚目の画像」「2 枚目の画像」と呼んでください。画像の一部だけを変更したい場合は、インペインティングのほうが確実です。
複数の画像を合成する
複数の参照画像を一度に送信します。アップロード順が、プロンプト内の「1 枚目の画像」「2 枚目の画像」に対応します。カレントディレクトリに input.png と input2.png を置いてください。
cURL
# 1 リクエストあたり最大 16 枚、1 枚あたり ≤ 15 MB
curl -s https://api.ofox.ai/v1/images/edits \
-H "Authorization: Bearer YOUR_OFOX_API_KEY" \
-F "model=openai/gpt-image-2.5-flare" \
-F "image[]=@input.png" \
-F "image[]=@input2.png" \
-F "prompt=1 枚目の画像の被写体を 2 枚目の画像の背景の上に配置する" \
-F "quality=low" \
-o response.json
jq -r '.data[0].b64_json' response.json | base64 --decode > output.pngプロバイダー
プロバイダーを指定する必要はありません。3 つのモデルとも、Azure と OpenAI の両方が編集エンドポイントを提供しており、ゲートウェイが自動でルーティングします。
コンテンツ審査に関する要件がある場合はプロバイダーを指定できますが、編集エンドポイントで使えるのは X-OfoxAI-Provider-Type ヘッダーのみで、フォーム内の extra_body は無視されます。プロバイダーを指定すると、そのプロバイダーが利用できない場合でも他のプロバイダーには切り替わりません。プロバイダーの指定を参照してください。
パラメーターの値
編集エンドポイント固有のパラメーターです。model、n、output_format などはテキストからの生成と同じです。テキストから画像生成 · パラメーターの値を参照してください。
編集する画像です。複数の画像を送る場合は、フィールド名を image[] として繰り返し指定します。Python SDK ではリストを渡します。
▸ 詳細
参照画像もトークンとして課金されます。1024×1024 の参照画像は実測で 1,024 入力トークンとなるため、同じサイズでも編集はテキストからの生成より高くなります。
▶高度な設定 · 1X-OfoxAI-Provider-Type展开
通常は不要です。ゲートウェイが自動でルーティングします。特定のプロバイダーに固定したい場合にのみ使用してください。
アップロード制限
モデルは参照画像を約 1024 px に縮小して処理します。5 MB を超えるファイルはアップロードが遅くなるだけで、結果は向上しません。
よくあるエラー
その他のエラーはエラー一覧を参照してください。
公式ドキュメント
OpenAI のドキュメントは、OpenAI に直接呼び出した場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このシリーズの実測結果が優先されます。たとえば、編集時にプロバイダーを指定する必要はありません。