Skip to main content

簡潔な回答

gpt-image-2 を使用し、リクエストに 2 つのフィールドを追加します:
画像は実際のアルファチャンネルを持つ PNG として返されます — 切り抜き後処理は不要です。text-to-image、画像編集、そして Responses の画像ツールがすべて対応しています。
background: "transparent" は、OpenAI が 2026-08-21 に GPT-Image-2 向けに公開した機能です(OpenAI によるプレビューとしてマークされています)。APIYI はこれをエンドツーエンドで検証済みです。text-to-image と画像編集の両方で、真のアルファ透過を返します。

透明な背景を生成できるモデル

透明性を確実に必要とする場合は、gpt-image-2 を使ってください。 パラメータによる指定と prompt での依頼は同じではありません。前者は API によって保証されますが、後者は model が最善を尽くすだけです。バッチ規模になると、その差がはっきり表れます。

呼び出し方法は3通りあります

テキストから画像へ /v1/images/generations

画像編集 /v1/images/edits

普通の写真を渡して、背景を取り除くように依頼します:
マスクベースのインペインティング(mask)と透明な背景は併用できます。互いに競合しません。

Responses 画像ツール

返された image_generation_call"background": "transparent" を反映します。

なぜ jpeg が動作しないのか

JPEG には alpha チャンネルがありません — 透明度を保存する場所がないためです。output_format: "jpeg"background: "transparent" を組み合わせると 400 が返されます:
透明度が必要な場合は、png(ロスレスで、サイズは大きめ)または webp(ロッシーで調整可能、サイズは小さめ、さらに alpha もサポート)を選んでください。webp はさらにファイルサイズを削減するために output_compression も受け付けます。

編集は精密な切り抜きではなく、描き直しです

ここで最初に期待値をそろえておきます。/v1/images/editsbackground: transparent で実行されると、モデルは Photoshop のように元の輪郭をなぞるのではなく、シーンを理解して被写体を描き直します。つまり、次のようになります。
  • 被写体のポーズ、スタイル、細部は変化します — これはピクセル単位の保持ではありません
  • 元の画像により近づけるには、quality: "high"を使い、プロンプトに「元の構図を維持し、被写体の見た目を変更しないでください」と記載します
  • ワークフローでピクセル単位の正確な抽出が必要な場合は、rembgPIL、またはsharpで自分で切り抜きを行ってください。モデル生成は、正確なマット処理よりも「再利用可能なアセットを生成する」用途に適しています

課金

透明性に追加料金はかかりません。 同じ品質ティアとサイズであれば、background: "transparent"background: "opaque" はまったく同じ数の image tokens を消費し、gpt-image-2 に対する通常の token 単位の課金ルールに従って請求されます。

よくあるエラー

output_formatjpegに設定されていました。pngまたはwebpに切り替えてください。
3 つ確認してください。まず、backgroundフィールドが実際に API に届いているかです。edits エンドポイントはmultipart/form-dataなので、JSON 本文のフィールドではなく-F background=transparentでなければなりません。次に、レスポンスのトップレベルのbackgroundtransparentを返しているかです。最後に、gpt-image-2を使っているかです。gpt-image-2-allgpt-image-2-vipにはそのようなパラメータがなく、黙って無視されます。
Python のスニペットが 1 つあれば十分です:
Mode RGB は、アルファチャンネルがまったくないことを意味します。すべての alpha 値が 255 の Mode RGBA は、チャンネルは存在するものの、何も切り抜かれていないことを意味します。
prompt はそのように描画するようモデルに依頼するだけで、モデルは透明に見えるだけのグレーと白のチェッカーボードを描くことがあります。そうしたピクセルはまだ不透明です。実際のアルファチャンネルを保証するのは、background: "transparent"パラメータだけです。

関連ドキュメント

GPT-Image-2 の概要

すべてのパラメータ、サイズ、品質ティア、エラーコード

テキストから画像への API リファレンス

/v1/images/generations のすべてのフィールド

画像編集 API リファレンス

/v1/images/edits と複数画像の融合

マスクインペインティング

変更する領域を示すためにアルファマスクを使用します

公式ルートとリバースルート

gpt-image-2 / -all / -vip の選択

白背景でのアーティファクト

純白背景における別の問題