ブラックフライデーチャージボーナス
対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。
11月30日まで
商品ページでは同じ商品を何度も使う必要があります。白背景、キッチンカウンターの上、手に持ったところ、今季キャンペーンのカラー。 image generation API を使えば、商品は一度撮影するだけで、あとはコードで作れます。写真を参照画像として POST /v1/images/edits に送り、シーンを記述すると、1リクエストから最大10バージョンが返ります。背景や小道具、合わせたいスタイルの参照画像を2枚目として追加できます。GPT Image 2 または GPT Image 2.5 なら、サイズや品質にかかわらず1枚 $0.04 なので、カタログ撮影の費用は始める前に分かります。コードなしで image playground で試せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Build a batch job that turns product photos into packshots and lifestyle scenes with the Lovely Router images API. - Docs (read first): https://lovelyrouter.com/docs/models/images.md - POST https://lovelyrouter.com/v1/images/edits with the product photos as `image[]` references (or queue them with POST https://lovelyrouter.com/v1/images/jobs and fetch them when done); `n` asks for several images at once. One flat price per image. - Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys. - Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large. - Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt. My task: <the product photos and the scenes you want>
仕組み
商品を一度撮影する
無地の背景に商品を写した鮮明な写真(PNG、JPEG、WebP)。モデルはこの参照画像から形、色、ラベルを保ちます。
ショットを記述する
写真を
image[]として、シーンのプロンプトと一緒に送ります。「白いシームレス背景、柔らかなスタジオ光、中央配置」または「窓際の大理石の洗面カウンター、朝の光」。背景、小道具、スタイルの参考にしたい写真があればimage[]ファイルを追加し(最大16枚)、それぞれから何を取り入れるかをプロンプトで指定します。複数バージョンを取得する
同じプロンプトで複数枚得るには
nを1〜10に設定します。受け取った画像ごとに支払い、GPT Imageモデルでは4枚でも1枚とほぼ同じ時間で済みます。選び、確認し、公開する
最良のものを残し、実物と比較し、ずれたものは再生成します。カタログ全体なら、リクエストを画像ジョブとしてキューに入れ、完了したら回収します。
リクエスト
商品写真1枚と背景1枚で、4バージョンが返ります:
curl https://lovelyrouter.com/v1/images/edits \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-F model=gpt-image-2.5-flare \
-F "image[]=@mug.png" \
-F "image[]=@oak-table.jpg" \
-F prompt="The mug from the first image on the oak table from the second, steam rising, soft morning light from the left, shallow depth of field" \
-F size=2048x2048 \
-F n=4 | jq '.data | length'カタログを画像ジョブとして送れば、接続を開いたままにするリクエストはありません:
import os
import requests
BASE = "https://lovelyrouter.com/v1"
H = {"Authorization": f"Bearer {os.environ['LOVELY_API_KEY']}"}
SCENES = [
"on a white seamless background, soft even studio light, centred, no shadows",
"on a light wood kitchen counter beside fresh herbs, natural window light",
]
jobs = []
for sku in ["mug-blue", "mug-green", "teapot-black"]:
for scene in SCENES:
r = requests.post(f"{BASE}/images/jobs", headers=H,
data={"model": "gpt-image-2", "prompt": f"The product from the image {scene}",
"size": "2048x2048", "n": "2"},
files={"image": open(f"{sku}.png", "rb")})
jobs.append((sku, r.json()["id"]))
for sku, job_id in jobs:
job = requests.get(f"{BASE}/images/jobs/{job_id}?wait=300", headers=H).json()
for i, image in enumerate(job["result"]["images"] if job["status"] == "succeeded" else []):
with open(f"{sku}-{job_id}-{i}.png", "wb") as f:
f.write(requests.get(image["url"], headers=H).content)アカウントは同時に最大20枚までキューまたは生成中にできます(n の各画像も数えます)。それを超えるリクエストは 429 になるので、カタログはバッチで送ってください。結果は7日間ダウンロードできます。images guide には同じ呼び出しの Node.js 版と OpenAI SDK 版があります。
モデル
| モデル | 価格 | 備考 |
|---|---|---|
gpt-image-2 | 1枚あたり $0.04 | quality は low から high まで、すべて同じ価格 |
gpt-image-2.5-flare | 1枚あたり $0.04 | quality は効果なし |
gpt-image-2.5-sunburst | 1枚あたり $0.04 | quality は効果なし |
3つとも生成と編集ができ、最大16枚の参照画像を受け付け、最大3840×2160のサイズを作れます: 1024x1024、1536x1024、1024x1536、2048x2048、3840x2160、または両辺が16の倍数で、長辺が最大3840ピクセル、短辺の最大3倍までの任意のサイズ。編集の費用は生成と同じです。
作業のためのツール
1回の編集につき最大16個の image[] ファイル、または JSON で images として URL か data: URL。入力画像は PNG、JPEG、WebP で合計最大50 MB。URL はリクエスト到着時に一度だけダウンロードされます。
n は1〜10。n 枚分の価格が確保され、受け取った画像にのみ支払います。
編集に mask を送ると、商品の背後の背景など、画像の一部だけを変更できます。
png または webp 出力で background: "transparent"。自分のページに配置する切り抜き用です。
png、jpeg、webp。jpeg と webp には output_compression を指定できます。
POST /v1/images/jobs は同じフィールドを受け取り、すぐに返します。GET /v1/images/jobs/{id}?wait= をポーリングまたはロングポーリングし、各画像を url からダウンロードします。キューのジョブは無料でキャンセルできます。
MCP server には URL で参照画像を受け取る generate_image ツールがあるので、Claude Code や Cursor がストアを構築しながら商品ショットを作れます。
レシピ
商品ごとに「純白のシームレス背景、中央配置、柔らかな影」と size=2048x2048 で1リクエスト。正方形画像を求めるマーケットプレイス向け。
商品ごとに3つのシーンプロンプト(キッチン、デスク、屋外)を n: 3 で。商品ごとに9枚から選べます。
すべてのリクエストで同じスタイル写真を2番目の image[] として渡し、季節の画像が光、色、小道具を共有するようにします。
1つのバリエーションを撮影し、「同じマグをマットなフォレストグリーンで」と依頼し、公開前に実物の写真と比較します。
横長の 3840x2160 または縦長の 1024x1536 のシーンで、片側に自分の見出し用の空きを残します。
公開前に確認すること
モデルは商品の形と色をよく保ちますが、画像は描き直されるため、ラベルの文字、ロゴ、ボタンの数、生地の織り目など小さな点が変わり得ます。使う画像はすべて実物と比較し、ずれたものは再生成し、正確なディテールが重要なところでは実写真を使ってください。モデルの安全システムに拒否されたプロンプトは 400 を返し、課金されません。
よくある質問
実物の商品は保たれますか?+
写真は参照として使われるため、形や色、ラベルはたいてい引き継がれますが、画像は合成ではなく描き直されます。公開前に小さな文字やロゴを実物と確認してください。
1リクエストで何枚取得できますか?+
n で最大10枚。それぞれ1枚分の価格で、アカウントは同時に20枚までキューまたは生成中にできます。
4K画像は高くつきますか?+
いいえ。どの画像も $0.04 で、1024×1024から3840×2160まで、品質を問いません。
参照画像を複数使えますか?+
はい、1回の編集につき最大16枚まで。商品、背景、小道具、スタイル写真などです。それぞれから何を取り入れるかをプロンプトで指定してください。
透過背景にできますか?+
はい。png または webp 出力で background: "transparent" を設定してください。
商品を動画広告にできますか?+
はい、同じキーで他のAPIを使って。AI UGC ads をご覧ください。ここで商品ショット、video shots でプレゼンター、テキスト読み上げでナレーションを作れます。
AIエージェントがカタログを撮影できますか?+
はい。このページのプロンプトを Claude Code、Cursor、Codex に貼り付けてください。Markdown ドキュメントを読み、あなたのキーでバッチを書きます。
すべてのフィールドと制限は images guide をご覧ください。始めるには アカウントを作成 して image playground を開いてください。