Skip to Content
モデルの使い方GPT Image画像編集・複数画像の合成

画像編集・複数画像の合成

1 枚または複数の画像をアップロードし、プロンプトで編集・合成します。

コードを書かない場合は、手持ちのツールで画像生成を参照してください。

POST/v1/images/edits共通パラメーター

始める前に

必要なもの詳細
API キーOfoxAI コンソール で作成し、コード内の YOUR_OFOX_API_KEY を置き換えてください
実行環境cURL では画像のデコードに jq が必要です。Python では pip install openai が必要です。Node.js は 18 以上で、依存パッケージは不要です
画像カレントディレクトリに input.png を置いてください。複数画像を合成する場合は input2.png も置いてください。PNG または JPEG、1 枚あたり ≤ 15 MB
タイムアウトクライアントのタイムアウトを 600 秒に設定してください。高品質・大サイズ・編集では数分かかる場合があります
コードで使用する値
API URLhttps://api.ofox.io/v1
モデル IDopenai/gpt-image-2.5-sunburstコード例では flare を使用していますが、編集には sunburst を推奨します
API キーコード内の YOUR_OFOX_API_KEY をご自身のキーに置き換えてください
Python の依存パッケージpip install openai

画像を編集する

以下のコード例はすべてそのまま実行して動作を確認しています。結果はカレントディレクトリに output.png として保存されます。

Terminal
curl -s https://api.ofox.io/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.png

size を省略すると、出力サイズはモデルが決定するため、元の画像と異なる場合があります。元のサイズを維持したい場合は、size=1024x1024 のように明示的に指定してください。

プロンプトの書き方

何を変えるかと、何をそのまま残すかの 2 点を明確に書いてください。

用途プロンプトの例
1 枚の画像を編集背景を木目のテーブルに置き換え、被写体はそのままにする
複数画像を合成1 枚目の画像の被写体を 2 枚目の画像の背景の上に配置する

複数の画像を使う場合は、アップロード順に「1 枚目の画像」「2 枚目の画像」と呼んでください。画像の一部だけを変更したい場合は、インペインティングのほうが確実です。

複数の画像を合成する

複数の参照画像を一度に送信します。アップロード順が、プロンプト内の「1 枚目の画像」「2 枚目の画像」に対応します。カレントディレクトリに input.png と input2.png を置いてください。

Terminal
# 1 リクエストあたり最大 16 枚、1 枚あたり ≤ 15 MB curl -s https://api.ofox.io/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必須fileform

編集する画像です。複数の画像を送る場合は、フィールド名を image[] として繰り返し指定します。Python SDK ではリストを渡します。

▸ 詳細

参照画像もトークンとして課金されます。1024×1024 の参照画像は実測で 1,024 入力トークンとなるため、同じサイズでも編集はテキストからの生成より高くなります。

▶高度な設定 · 1X-OfoxAI-Provider-Type展开
X-OfoxAI-Provider-Typestringheader· 有効な値azure_foundryopenai

通常は不要です。ゲートウェイが自動でルーティングします。特定のプロバイダーに固定したい場合にのみ使用してください。

アップロード制限

項目制限
参照画像 1 枚あたり≤ 15 MB
リクエスト全体≤ 50 MB
画像の枚数ゲートウェイ側の制限なし。16 枚以下を推奨
形式PNG、JPEG

モデルは参照画像を約 1024 px に縮小して処理します。5 MB を超えるファイルはアップロードが遅くなるだけで、結果は向上しません。

よくあるエラー

エラー原因対処法
Invalid image file or modeアップロードした画像が標準的な PNG または JPEG ではないPNG または JPEG として書き出し直してください
Invalid file 'image[0]': unsupported mimetypeアップロードしたファイルが画像ではないPNG、JPEG、WebP のいずれかの画像をアップロードしてください
does not support the 'input_fidelity' parameterinput_fidelity を送信した削除してください。このファミリーは常に高忠実度で参照画像を処理します
moderation_blockedプロンプトまたは参照画像が上流の安全システムでブロックされたプロンプトまたは参照画像を変更して再試行してください
provider_type_unavailable手動で指定したプロバイダーがこのモデルを提供していないX-OfoxAI-Provider-Type ヘッダーを削除してください
Invalid size指定したサイズが 4 つのルールのいずれかに違反しているサイズを参照
404 model_not_foundモデル ID のスペルミスまたは大文字・小文字の誤りこのページからモデル ID をコピーしてください

その他のエラーはエラー一覧を参照してください。

公式ドキュメント

OpenAI のドキュメントは、OpenAI に直接呼び出した場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このシリーズの実測結果が優先されます。たとえば、編集時にプロバイダーを指定する必要はありません。

Last updated on