画像を編集

multipart/form-data でソース画像をアップロードし、テキストプロンプトで編集します。OpenAI client.images.edit() と互換。内部では image-to-image パイプラインを再利用し、レスポンスは常に同期 JSON です。mask は未対応、response_format は URL のみ対応(b64_json は拒否されます)。

POST/api/v1/images/edits

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

image必須

file

編集するソース画像ファイル。image フィールドの繰り返し(または image[])で複数指定可能。最大 8 枚、各 10 MB まで、MIME は image/* 必須。

≤ 8 files, ≤ 10 MB each, image/*

prompt必須

string

適用する編集内容のテキスト記述。

minLength: 1

Example: "change the background to a night city"

model

string

画像編集モデル。省略時はサーバーのデフォルト(現在は gpt-5.4-image-2)が適用されます。

Example: "openai/gpt-5.4-image-2"

n

integer

生成する結果の数、1–10。

1–10

Example: 1

size

string

出力サイズ。「幅x高さ」のピクセル形式(例:1024x1024)必須。それ以外の形式は静かに無視されます。

format: <width>x<height>

Example: "1024x1024"

詳細ガイド →

POST /api/v1/images/edits

1
2
3
4
5
curl https://bazaarlink.ai/api/v1/images/edits \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -F model="openai/gpt-5.4-image-2" \
  -F image=@cat.png \
  -F prompt="change the background to a night city"

レスポンス例

成功。常に同期 JSON を返します(SSE ストリームは内部で処理)。client.images.edit() と互換。

1
2
3
4
5
6
7
8
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ]
}