画像

画像編集と参照画像

画像モデルに参照画像を渡すことで、写真の編集、商品を別のシーンに配置、複数の画像で同じキャラクターを維持、複数の画像の合成ができます。

画像を送る2つの方法

エンドポイント入力適した用途
POST /v1/images/editsOpenAIのmultipartフォーム(画像ファイル)、またはJSONOpenAIのSDK: client.images.edit(...)
POST /v1/images/generationsimagesリストを含むJSON任意のHTTPクライアント。画像はリンクまたはデータURLで指定

どちらも画像生成と同じモデル、サイズ、料金に対応しています。編集料金は、同じサイズの画像を新規生成する場合と同じです。

モデルごとに指定できる画像の枚数

モデルIDサイズと料金参照画像
Nano Banana 2.1nano-banana-2.11K $0.03 · 2K $0.04 · 4K $0.06最大14
Nano Banana Pronano-banana-pro1Kと2K $0.035 · 4K $0.065最大14
Nano Banana 2nano-banana-21K $0.025 · 2K $0.034 · 4K $0.058最大14
Nano Banana 2 Litenano-banana-2-lite1K $0.016最大14
GPT Image 2.5 Flaregpt-image-2.5-flare1K $0.028 · 2K $0.034 · 4K $0.045最大16
GPT Image 2.5 Sunburstgpt-image-2.5-sunburst1K $0.026 · 2K $0.034 · 4K $0.045最大16
GPT Image 2gpt-image-2画像あたり$0.02最大16
Grok Imagine Image 2.0grok-imagine-image-2.01K $0.045 · 2K $0.06最大3
FLUX 3 Imageflux-3-image1K $0.04 · 2K $0.05 · 4K $0.09最大1

OpenAIのSDKを使う

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.zurelay.com/v1", api_key=os.environ["ZURELAY_API_KEY"])
result = client.images.edit(
model="gpt-image-2",
image=[open("product.png", "rb"), open("background.jpg", "rb")],
prompt="Put the bottle from the first image on the marble counter in the second. Keep its label exactly.",
)
print(result.data[0].url)

JSONを使う

どちらのエンドポイントでも、images に画像をリンクまたはデータ URL として指定します(画像が1枚なら image も使えます):

import os
import requests
response = requests.post(
"https://api.zurelay.com/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"},
json={
"model": "nano-banana-pro",
"prompt": "Make the jacket in the first image deep green, and give the model the pose from the second.",
"images": [
"https://example.com/model.jpg",
"data:image/png;base64,iVBORw0KGgo..."
],
"size": "2K",
"aspect_ratio": "4:5"
},
)
response.raise_for_status()
print(response.json())

入力画像のルール

  • PNG、JPEG、WebP に対応し、画像ごとの上限は 20 MB です。
  • リンクには公開された https URL を指定してください。画像は Zurelay 側でダウンロードします。ダウンロードできない場合は、生成を始める前に invalid_image でリクエストを拒否します。
  • プロンプトでは画像を順番で指定します。「1枚目の画像」「2枚目の画像」のように記述してください。
  • マスクには対応していません。代わりに「空だけを差し替える」のように変更内容を説明してください。モデルは指定した部分だけを編集します。
  • モデルの上限を超えるリクエストは、上限を明示したエラーで拒否されます。

試してみる

目的プロンプトの例
1か所だけ編集“車をマットブラックに変更してください。ほかはすべてそのままにしてください。”
背景を変更“画像の人物を夕暮れのビーチに配置し、光の当たり方を合わせてください。”
商品を別のシーンに配置“1枚目の画像の商品を、2枚目の画像の棚に置いてください。”
同じ人物で別のシーン“参照画像と同じ女性が、今度は Paris で自転車に乗っている様子を描いてください。”
スタイルを適用“1枚目の画像を、2枚目の画像のスタイルで描き直してください。”
複数の画像を組み合わせる“画像に写っている6人が階段に立っている集合写真を作成してください。”

ご質問や不足している情報はありますか? サポートチームにお問い合わせください。通常1分以内にメールで回答します。