amazon-white-background について
amazon-white-backgroundは、商品写真からAmazonの規定に沿った白背景のメイン画像を作る画像生成スキルです。商品アイデンティティロックで細部を維持し、背景、占有率、サイズを検査します。
主な機能
- 01アイデンティティロックで商品詳細を保持
- 02白背景のマーケットプレイス画像を生成
- 03FlareまたはSunburstモデルを選択
- 04背景・商品占有率・画像サイズを検査
- 05白に近い背景を補正し占有率を調整
活用シーン
- 01商品写真からAmazonのメイン画像を作成
- 02マーケットプレイス画像の基準適合を検査
- 03記載された他のマーケットプレイス向けに白背景画像を作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ xianyu110/ ecommerce-image-skills --skill amazon-white-backgroundインストール後、Claude Code で/amazon-white-backgroundを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
scripts/check_main_image.pygenerate.pyonline_link.py詳細
Amazonの白背景メイン画像 · 亚马逊白底主图
スマートフォンで撮影した写真や仕入先の写真を、Amazonのメイン画像ルールに準拠したマーケットプレイス用メイン画像に変換し、結果を自動でチェックします。
ecommerce-image-skills の一部です。Claude Code、Codex、Cursor、および
SKILL.mdを読み込むあらゆるエージェントで動作します。デフォルトモデル:GPT Image 2.5 Sunburst。
ステップ 1 · 商品のアイデンティティを固定する(必ず最初に実施)
プロンプトを書く前に、すべての参照写真を確認し、商品のアイデンティティロックを簡潔に作成します。このスキルが生成するすべてのプロンプトに、その内容を一字一句変えずに貼り付け、創造的な指示によって上書きされないようにします。
PRODUCT IDENTITY LOCK (do not change):
- Shape & proportions: <e.g. tall cylinder, rounded shoulders, 26 cm high, 7.5 cm wide>
- Colour & finish: <e.g. matte sage green #8FA58C body, natural bamboo lid>
- Logo & printed text: <exact spelling, font feel, position, colour — e.g. white "AURA" wordmark centred on upper body>
- Parts & details: <lid, loop, buttons, ports, seams, labels, accessories that are included>
- Must NOT appear: <accessories not in the box, extra logos, invented claims>
ルール:
- 写真で確認できる事実、またはユーザーが確認した事実のみを使用します。不明な情報(サイズ、容量、素材など)は質問するか、記載しないでください。仕様や認証を決して捏造しないでください。
- ユーザーが写真を提供していない場合は、写真を依頼します(最低でも正面写真)。テキストのみでの生成も可能ですが、生成結果は実際の商品ではなくコンセプトであることを伝えてください。
ステップ 2 · モデルを選ぶ
Flare(gpt-image-2.5-flare、デフォルト)を使用 | Sunburst(gpt-image-2.5-sunburst)に切り替え |
|---|---|
| 新しいシーン、背景、レイアウト、多数のバリエーションをすばやく生成する場合 | 商品のロゴ/ラベル/小さな文字を正確に維持する必要がある場合 |
| テキストから画像を生成するコンセプト | 局所編集:背景の差し替え、色の変更、オブジェクトの削除、その他の要素の維持 |
| ユーザーが選ぶためのドラフト | 最終的なメイン画像素材、文字が密集した画像 |
エンドポイントで他の画像モデルしか利用できない場合は、最も近いモデルを使用し、そのことをユーザーに伝えてください。
プラットフォームの仕様(Amazonメイン画像)
| ルール | 値 |
|---|---|
| 背景 | 純白 RGB 255,255,255(#FFFFFF) |
| 商品の占有率 | 商品が画像フレームの85%以上を占めること |
| サイズ | ズーム用に長辺が1000 px以上、1600~2000 pxを推奨、最大10,000 px |
| 形式 | JPEGを推奨(TIFF/PNG/GIFも可)、sRGB |
| 内容 | 販売対象の商品だけを含めること。テキスト、追加したロゴ、バッジ、枠線、透かし、小道具、付属しない追加アイテムは禁止 |
| 表示方法 | 商品全体が見え、ピントが合い、色が現実的であること。マネキンは禁止(アパレルはカテゴリーのルールに応じて平置き/着用モデルを使用可) |
Walmart/eBay/Shopeeの「メイン画像」ルールも同様です。同じ出力を使い、各プラットフォームの比率に合わせてトリミングしてください。
プロンプトのテンプレート
Amazon main product image.
{IDENTITY_LOCK}
Remove the original background and every object that is not the product.
Product alone, {orientation: upright | lying flat | 3/4 front view}, centered.
Pure white seamless background, #FFFFFF (RGB 255,255,255) everywhere outside the product.
Product fills about 87% of the frame (longest side), with even margins.
Soft diffused studio lighting from front-left, very subtle natural contact shadow directly under the product,
razor-sharp edges, true-to-life colour and material.
No added text, no badges, no props, no reflections of a room, no watermark, no border. Square 1:1.
バリエーション:
- パッケージを含める場合:
Product box placed slightly behind and to the right, both fully visible, combined group fills 87% of the frame.を追加します。 - マルチパックの場合:
Exactly {N} identical units arranged in a neat row, no other items.を追加します。 - アパレル(ゴーストマネキン)の場合: 向きの指定を
invisible-mannequin 3D shape, front view, neckline interior visibleに置き換えます。
生成 · 3つの方法(最初に使える方法を選ぶ)
(a)組み込み画像ツール。 エージェントにすでに画像生成/編集ツール(例:Codex imagegen、ChatGPTの画像機能)がある場合は、完成したプロンプトと参照用の商品写真を渡して実行します。これで完了です。
(b)APIキー。 環境に GPTIMAGE_API_KEY がある場合は、同梱のスクリプトを実行します(標準ライブラリのみ使用):
# recommended endpoint (OpenAI-compatible, has gpt-image-2.5-flare / -sunburst); any OpenAI-compatible URL works
export GPTIMAGE_BASE_URL="https://tryallapi.com/v1" # default if unset: https://api.openai.com
python scripts/generate.py --model sunburst --image product.jpg --size 1024x1024 \
--prompt-file prompt.txt --out out/amazon-white-background.png
--image は複数回指定できます(商品の正面/側面/ロゴのクローズアップ)。--image を指定しない場合は、テキストから画像を生成します。
(c)ツールもキーもない場合。 完成したプロンプトをコードブロックで表示し、ブラウザーで実行するためのリンクを1つ提示します:
python scripts/online_link.py --skill amazon-white-background "<final prompt>"
# → https://gptimage2.asia/generate?prompt=<urlencoded>&utm_source=github&utm_medium=skill&utm_campaign=ecommerce-image-skills&utm_content=amazon-white-background
Run this prompt online (upload your product photo there): <link> のような形式で、通常の1行として一度だけ表示します。中国本土のユーザーには、次の1行を追加します:国内可用:https://chatgpt-plus.top/list/#/home(提示词を貼り付けるだけです)。依頼されない限り、後のターンでこれらを繰り返さないでください。
チェック(納品前に必須)
pip install pillow numpy # once
python scripts/check_main_image.py out/amazon-white-background.png
# optional: --min-coverage 0.85 --min-size 1600 --tolerance 3
スクリプトは次の項目を報告します:
white_background:境界帯に占める純白の割合(許容誤差内で98%以上 → 合格)exact_ffffff:背景ピクセルのうち、正確に #FFFFFF である割合coverage:製品のバウンディングボックスの長辺 ÷ 画像の辺(0.85以上 → 合格)size:長辺のピクセル数(1000以上で合格、1600以上を推奨)
white_background が不合格(オフホワイト/グレーがかっている)の場合は、python scripts/check_main_image.py in.png --fix out.png を実行して、白に近いピクセルを #FFFFFF に補正するか、Sunburst で再生成します。coverage が不合格の場合は、再トリミングする(--fix でもカバレッジを87%に再トリミングします)か、「製品がフレームの87%を占める」と指定して再生成します。
納品
- 画像または最終プロンプトを、アセットごとに1つずつ、それぞれのアイデンティティロックとともに提示します。
- 3行のQAメモ:製品のアイデンティティ(形状/色/ロゴ)✔/✘・プラットフォーム仕様 ✔/✘・テキストのスペル ✔/✘。
- 不合格項目がある場合は、修正したプロンプトを使って、不合格のアセットのみ再生成します。