Skip to main content
POST
Image editing: edit a reference image or fuse two images
右側のインタラクティブなPlaygroundでは、ローカル画像のアップロードに対応しています。Authorization にAPIキーを入力し(形式: Bearer sk-xxx)、image ファイルを選択し、prompt と model を入力して送信してください。
🔴 このエンドポイントは multipart/form-data ファイルのアップロードのみを受け付けます/v1/images/edits に(image をURL、データURI、または生の base64 として)JSONを送信すると、400 が返されます:
入力としての画像URLはサポートされていません。 URLのみをお持ちの場合は、まずサーバー側でダウンロードしてからファイルをアップロードしてください。ファイルアップロードには画像のホスティングは不要です。ローカルファイルをそのまま送信してください。
ユースケース: このページは参照画像の編集や2枚の画像の合成を対象としています。テキストのみから生成する場合は、Text-to-Image APIをご利用ください。
⚠️ 2枚の画像を使用する場合、フィールド名は image + image2 であり、image[] ではありません2枚の参照画像を使用する場合、最初のフィールド名を image、2番目を image2 と指定してください。image[] の重複、image の重複、または mask フィールドの追加は、すべて 400 File must be attached in a form field with a name starting with 'image' を返します。これは、OpenAI SDKの複数画像フォーム client.images.edit(image=[f1, f2]) が動作しないことを意味します(image[] が送信されるため)。SDKを使用した単一画像の編集は問題なく動作します。
テキストからの画像生成と同じ禁止パラメータ: response_format、seed、または negative_prompt は送信しないでください(400が返されます)。レスポンスは常に data[0].b64_json(PNG)です。

コード例

Python(OpenAI SDK・単一画像)

Python(requests・単一画像)

Python(2画像合成・image + image2)

cURL

Node.js(fetch + FormData)

パラメータリファレンス

省略時の出力サイズ: 出力は元画像のアスペクト比に従い、16の倍数に調整されます(例: 1344×756 の入力は 1360×768 になります)。構図を維持したい部分編集の場合は、width / height を送信しないでください。

編集結果とプロンプティング

編集エンドポイントは、元の構図、色、ディテールを維持し、promptで指定された内容のみを変更します:
MAI-Image-2.6-Flashの編集例:ティーポットがクリーム色からコバルトブルーに変更され、その他はすべて変更なし
2画像の融合を行う場合は、prompt内でimage / image2を「image 1 / image 2」として参照してください。テストでは人物の同一性の再現度は中程度にとどまる(顔の特徴が変化する可能性があります)ため、ポートレートの一貫性が重要な場合は、まず少量のバッチで検証してください。

レスポンス形式

レスポンスフィールド
  • b64_json は data: プレフィックスのないプレーンな base64 であり、PNG にデコードされます。
  • n > 1 の場合、data 配列には複数のアイテムが含まれます。data[0] のみを取得しないようにしてください。
  • url および revised_prompt は返されません。
usage で課金の照合を行わないでください:プレースホルダーが保持されています(prompt_tokens は常に画像数 × 1000 となります)。画像編集のコストは Text-to-Image と同一であり、画像単位で課金されます。APIYI コンソールの請求明細が正式なものとなります。

承認

Authorization
string
header
必須

API key from the APIYI console

ボディ

multipart/form-data
model
enum<string>
デフォルト:MAI-Image-2.6-Flash
必須

Model ID (case-sensitive)

利用可能なオプション:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
必須

Edit instruction. State what to change and that everything else stays the same

例:

"Change the teapot to a deep cobalt blue glaze, keep everything else identical"

image
file
必須

Reference image file (the first one, "image 1" in the prompt). png / jpg / webp

image2
file

Optional second reference image ("image 2" in the prompt), for two-image fusion

width
integer

Optional output width. Same rules as text-to-image: each side ≥ 768, width × height ≤ 2,359,296, sent together with height

必須範囲: x >= 768
height
integer

Optional output height, same rules as width

必須範囲: x >= 768
n
integer
デフォルト:1

Number of images. Works on this endpoint, billed per image

必須範囲: x >= 1
例:

1

レスポンス

Image generated

created
integer

Creation timestamp

例:

1791000788

data
object[]

Image results; length equals n

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images