Edits（画像の修正）

1. 機能紹介

元画像とマスク画像（オプション）をアップロードし、テキストプロンプトと組み合わせて、AIモデルに画像の指定領域の内容を置き換え、編集後の画像を生成します。
GPT-ImageシリーズとDALL-E 2モデルをサポートし、画像修復、コンテンツ置換、スタイル調整などのシナリオに適用可能です。

精密な領域編集：マスク画像を通じて編集領域を指定し、局所的な内容置換を実現する

マルチモデル適合：GPT-Imageシリーズ（高効率で柔軟性がある）とDALL-E 2（古典的で安定している）をサポート

豊富なパラメータ制御：画像サイズ、品質、出力形式、圧縮レベルなどをカスタマイズ可能

一括生成：一度に1～10枚の編集済み画像の生成をサポートし、多様なニーズを満たします

透明背景対応：GPT-Imageモデルは透明背景の画像を生成でき、デザインシーンに適合します

2. リクエストパラメータ

フィールド	タイプ	必須	説明	備考
画像	文書	✅	元画像文書	≤ 50 MB；PNG/JPEG/WebP 対応
マスク	文書		マスク画像	元画像と同じサイズで、アルファチャンネルを含む必要があります
プロンプト	文字列	✅	編集プロンプト	長さ ≤ 32k（gpt-image-1.5）
モデル	文字列	✅	モデル	gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini
n	int		出力枚数	1-10
サイズ	文字列		出力サイズ	生成APIと同じ、サイズ表を参照
quality	string		品質	low / medium / high / auto
背景	文字列		背景	透明 / 不透明 / 自動
input_fidelity	文字列		入力本物保証	low / high；high は顔/ロゴをより良く保持できます
output_format	文字列		出力形式	png / jpeg / webp
output_compression	int		圧縮率	0-100；jpeg/webpのみ
モデレーション	文字列		審査の厳しさ	低 / 自動
stream	bool		ストリーミング	GPT-Imageシリーズのみ
partial_images	int		ストリーミングパーシャル	0-3
async	query		非同期かどうか	?async=true で task_id を返す

3. 注意事項

✅ オリジナル画像とマスク画像は、対応するモデルの形式およびサイズ制限を満たす必要があります（詳細はパラメータ説明を参照）

🎭 マスク画像は元画像と同じサイズである必要があり、透明領域（alpha=0）が編集領域となります。

🔒 機密コンテンツの編集はサポートされておらず、システムがコンテンツオーディットを行います

⚠️ APIFOXはこのAPIのオンラインデバッグをサポートしておらず、コード呼び出しによるテストが必要です

🚫 著作権侵害や違法な画像のアップロードは禁止されています

4. 価格

モデル	テキスト入力	画像入力	画像出力
gpt-image-1	5 PTC/1Mトークン	10 PTC/1Mトークン	40 PTC/1Mトークン
gpt-image-1-mini	2PTC/1Mトークン	2.5PTC/1Mトークン	8PTC/1Mトークン
gpt-image-1.5	5PTC/1Mトークン	8PTC/1Mトークン	32PTC/1Mトークン

最終価格はリクエスト返却時のTokens消費数に準拠します
gpt-image-1:価格参考

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

Example

{
    "background": "opaque",
    "created": 1765963391,
    "data": [
        {
            "url": "https://file.302.ai/gpt/imgs/20251217/3de34788dedd4b84834bb428ae742615.png"
        }
    ],
    "output_format": "png",
    "quality": "high",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 10977,
        "input_tokens_details": {
            "image_tokens": 10917,
            "text_tokens": 60
        },
        "output_tokens": 4160,
        "total_tokens": 15137
    }
}

1. 機能紹介#

2. リクエストパラメータ#

3. 注意事項#