ガイド
画像編集ガイド
Cheapest Imagen API で画像から画像を生成します。参照画像を 1 枚以上、ファイルまたはリンクで /v1/images/edits に送り、変更内容を書きます。
プロンプトと 1 枚以上の参照画像を POST /v1/images/edits に送信します。どのモデルでも参照画像を使え、編集に必要なクレジットは新規画像と同じです。
ファイルをアップロードする
リクエストをフォームとして送信します。参照画像ごとに image[] を繰り返してください。
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlOpenAI SDK の場合:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)ファイルの代わりにリンクを送る
images 配列を含む JSON を送信します。各項目には image_url を指定します。https: のリンク、または Base64 の data: URL を使えます。
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id には対応していません。image_url を指定してください。
制限
| 1 リクエストあたりの参照画像 | 1〜16 枚 |
| 画像 1 枚のサイズ | 最大 20 MB |
| リクエスト全体のサイズ | 最大 50 MB |
| ファイルの種類 | PNG、JPEG、WebP |
これらの制限を超えるリクエストは 413 を返します。
オプション
テキストから画像を生成のすべてのオプション(n、size、quality、output_format、response_format)が編集でも使えます。編集専用のオプションが 1 つあります。
| フィールド | 内容 | 値 |
|---|---|---|
input_fidelity | 結果が参照画像のディテールをどれだけ忠実に保つか | low(デフォルト)、high。GPT Image 2.5 と 2.6 およびその flare、sunburst 版で使えます。ほかのモデルは 400 を返します |
対応していないもの
- マスク。 1 か所だけを描き直すことはできません。変えたくない部分は、プロンプトで説明してください。
- 透過背景。
background: transparentは、どのモデルでも400を返します。
ヒント
- 被写体を変えたくない場合は、複数の角度の画像を送ってください。
- 変えてはいけない点を書きます。たとえば「ラベルはそのまま」「同じ顔と髪型」。
- 2K と 4K で出力するには、Nano Banana、
gpt-image-2-adobe、または flare か sunburst 版を使います。比率とサイズを参照してください。