ブラックフライデーチャージボーナス·$50以上のチャージで$10プレゼント · $100以上のチャージで$25プレゼント·11月30日までチャージ →
ユースケース

AI商品写真:
1枚の商品写真からパックショットとライフシーンを作る

1枚の商品写真から、GPT Image 2と2.5の編集でパックショットとライフシーンを作成。参照画像、1リクエスト最大10枚、1枚あたり定額。

最終更新日 2026-11-05

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
雪の森にいる水彩画のキツネ、夕暮れ
ブラックフライデー

ブラックフライデーチャージボーナス

対象のチャージごとに無料クレジットが付き、他の特典とも併用できます。

11月30日まで

$50をチャージ
+$10
20%ボーナス
$100をチャージ
+$25
25%ボーナス
登録して受け取る

商品ページでは同じ商品を何度も使う必要があります。白背景、キッチンカウンターの上、手に持ったところ、今季キャンペーンのカラー。 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>
01

仕組み

010203
  1. 商品を一度撮影する

    無地の背景に商品を写した鮮明な写真(PNG、JPEG、WebP)。モデルはこの参照画像から形、色、ラベルを保ちます。

  2. ショットを記述する

    写真を image[] として、シーンのプロンプトと一緒に送ります。「白いシームレス背景、柔らかなスタジオ光、中央配置」または「窓際の大理石の洗面カウンター、朝の光」。背景、小道具、スタイルの参考にしたい写真があれば image[] ファイルを追加し(最大16枚)、それぞれから何を取り入れるかをプロンプトで指定します。

  3. 複数バージョンを取得する

    同じプロンプトで複数枚得るには n を1〜10に設定します。受け取った画像ごとに支払い、GPT Imageモデルでは4枚でも1枚とほぼ同じ時間で済みます。

  4. 選び、確認し、公開する

    最良のものを残し、実物と比較し、ずれたものは再生成します。カタログ全体なら、リクエストを画像ジョブとしてキューに入れ、完了したら回収します。

02

リクエスト

商品写真1枚と背景1枚で、4バージョンが返ります:

cURL
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'

カタログを画像ジョブとして送れば、接続を開いたままにするリクエストはありません:

Python
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 版があります。

03

モデル

モデル価格備考
gpt-image-21枚あたり $0.04quality は low から high まで、すべて同じ価格
gpt-image-2.5-flare1枚あたり $0.04quality は効果なし
gpt-image-2.5-sunburst1枚あたり $0.04quality は効果なし

3つとも生成と編集ができ、最大16枚の参照画像を受け付け、最大3840×2160のサイズを作れます: 1024x1024、1536x1024、1024x1536、2048x2048、3840x2160、または両辺が16の倍数で、長辺が最大3840ピクセル、短辺の最大3倍までの任意のサイズ。編集の費用は生成と同じです。

04

作業のためのツール

参照画像。

1回の編集につき最大16個の image[] ファイル、または JSON で images として URL か data: URL。入力画像は PNG、JPEG、WebP で合計最大50 MB。URL はリクエスト到着時に一度だけダウンロードされます。

1リクエストで複数枚。

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 がストアを構築しながら商品ショットを作れます。

05

レシピ

白背景パックショット。

商品ごとに「純白のシームレス背景、中央配置、柔らかな影」と size=2048x2048 で1リクエスト。正方形画像を求めるマーケットプレイス向け。

ライフスタイルセット。

商品ごとに3つのシーンプロンプト(キッチン、デスク、屋外)を n: 3 で。商品ごとに9枚から選べます。

カタログ全体で1つのルック。

すべてのリクエストで同じスタイル写真を2番目の image[] として渡し、季節の画像が光、色、小道具を共有するようにします。

カラーバリエーション。

1つのバリエーションを撮影し、「同じマグをマットなフォレストグリーンで」と依頼し、公開前に実物の写真と比較します。

バナーとソーシャル投稿。

横長の 3840x2160 または縦長の 1024x1536 のシーンで、片側に自分の見出し用の空きを残します。

06

公開前に確認すること

モデルは商品の形と色をよく保ちますが、画像は描き直されるため、ラベルの文字、ロゴ、ボタンの数、生地の織り目など小さな点が変わり得ます。使う画像はすべて実物と比較し、ずれたものは再生成し、正確なディテールが重要なところでは実写真を使ってください。モデルの安全システムに拒否されたプロンプトは 400 を返し、課金されません。

07

支払いについて

生成も編集も、どのサイズ・品質でも1枚 $0.04。50商品を2シーン×2バージョンで撮るカタログは200枚で $8。価格は送信時に前払い残高から確保され、各画像の生成時に課金されます。拒否・キャンセル・失敗したリクエストは無料です。GET /v1/models は現在の価格を pricing.per_image として表示し、すべての呼び出しは logs に残ります。すべての価格は pricing にあります。

08

よくある質問

?
実物の商品は保たれますか?+

写真は参照として使われるため、形や色、ラベルはたいてい引き継がれますが、画像は合成ではなく描き直されます。公開前に小さな文字やロゴを実物と確認してください。

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 を開いてください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。