本文へスキップ
Cheapest Imagen
ガイド

画像編集ガイド

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=url

OpenAI 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 版を使います。比率とサイズを参照してください。

このページの内容