电商商品画像制作

电商商品画像制作 は何をしますか？

目标

一张真实的商品照片を、迅速に2つの納品可能な画像に変換します：

1. 白背景保真画像：元の背景を除去し、商品を純白の背景に配置します。商品の外観とパッケージ情報をすべて保持します。
2. リアルなEコマースヒーロー画像：白背景保真画像を唯一の商品事実情報源として、清潔で信頼性があり、Eコマース表示に使用できるシーン画像を生成します。

デフォルトでは、必要な照明、構図、背景処理のみを行い、商品の「再デザイン」は行いません。

入力

• SOURCE_IMAGE：クライアントから提供される実際の商品の元画像。必須。
• STYLE_REFERENCE：オプションのEコマース構図参照画像。レイアウト、照明、余白、情報の階層のみを参考にし、商品、テキスト、価格、認証、キャッチコピーは複製しません。
• OUTPUT_DIR：出力ディレクトリ。デフォルトは ./outputs/product-images/。

複数の画像を受け取った場合、どれが商品の事実画像で、どれがスタイル参照画像であるかを最初に判断します。スタイル参照画像の商品の詳細を元の商品に上書きしてはいけません。

固定フロー

1. APIMart ルールの読み取り

現在の環境で利用可能なAPIMartツールを使用するか、APIMart公式インターフェースドキュメントに従ってアップロード、認証、非同期ポーリング方式で呼び出します。API Keyは APIMART_API_KEY などのユーザー設定の環境変数または安全な資格情報マネージャーから読み取ります。サービスアドレスは APIMART_BASE_URL またはサービスプロバイダーの公式設定を使用します。鍵、ユーザーファイル、一時URLをスキルファイル、スクリプト、ログ、納品文書に書き込んではいけません。資格情報またはサービスアドレスが設定されていない場合は、設定が必要であることを説明し、他のユーザーの鍵を不正に使用したり検索したりしてはいけません。APIには課金が発生する可能性があります。ユーザーがAPIMartを使用して元画像を処理することを指定または同意している場合は、このタスクを実行し、費用について通知します。そのような承認がない場合、ユーザーがアップロードを拒否した場合、またはサービスが設定されていない場合は、最初に説明します。

メインモデルは固定で gpt-image-2.6-flare-ext です。インターフェースが明確に「モデルが存在しません」を返した場合のみ、APIMartで利用可能なGPT Image拡張モデルを使用し、結果にフォールバックが発生したことを説明します。静かにモデルを変更してはいけません。

2. 元画像のアップロード

APIMart画像アップロードインターフェースを使用して SOURCE_IMAGE をアップロードし、source_url を取得します。STYLE_REFERENCE がある場合は、個別にアップロードして style_url を取得します。アップロード完了後、すぐにタスク記録を保存します。一時URLをクライアントの納品文書に書き込んではいけません。

3. 白背景保真画像の生成

APIMart画像生成/編集インターフェースを呼び出し、source_url を唯一の商品参照として使用します。プロンプトは以下のテンプレートを直接使用し、角括弧内の内容を置き換えます：

Edit the provided product photo into a clean e-commerce white-background product cutout.
The product identity is locked to the source image.
Preserve exactly: package shape, front and side panels, dimensions, proportions, colors,
logos, labels, Chinese text, English text, dosage/volume markings, seals, caps, edges,
folds and all visible printed details.
Remove only the original environment and background. Use a pure white background,
soft natural contact shadow, centered product, full product visible, realistic camera
perspective, accurate geometry, high-detail commercial photography.
Do not redesign, beautify into another product, rewrite text, translate text, add text,
remove text, change the package, change the brand, change the logo, change the color,
add props, add people, add medical claims, add badges, add price tags or add decorative
copy. If any printed text is uncertain, preserve the original appearance rather than
inventing a replacement.

出力ファイル名：01_white_bg_preserved.png。

4. 保真チェック

Eコマース画像の生成に入る前に、白背景画像をチェックする必要があります：

• パッケージの正面、側面、上部、端部が元の画像と一致しているか。
• 商品の数量、サイズ比率、色、遠近感、構造が変更されていないか。
• ブランド、商標、承認番号、仕様、中国語、英語が書き換えられたり、文字化けしていないか。
• 余分なボトル、箱、植物、錠剤、人物、価格、認証、効能を示す単語、装飾が表示されていないか。
• 背景は白色か、商品は完全に表示されているか、明らかな切り抜きの粗いエッジや透過がないか。

いずれかの項目に失敗した場合：完成品として納品しないでください。同じ元画像を使用して、「identity locked / preserve exact packaging / no new text」を強化し、最大1回再試行します。それでも合格しない場合は、明確に REJECTED とマークし、完了したふりをしたり、無限に再試行しないでください。

5. リアルなEコマースヒーロー画像の生成

01_white_bg_preserved.png を商品事実画像として使用します。STYLE_REFERENCE は構図の参考としてのみ使用します。プロンプトは以下を使用します：

Create one realistic e-commerce product hero image using the provided preserved product cutout.
The supplied cutout is the exact product truth and must remain unchanged.
Keep the same package shape, logo, brand, printed text, colors, proportions, side panel,
volume markings and all visible details. Do not redraw or reinterpret the product.
Build a clean, credible commercial composition with [SCENE], [LIGHTING], [CAMERA_ANGLE]
and generous negative space. Use premium but restrained styling, realistic shadows and
accurate materials. No people, no hands, no extra products, no medical advice, no efficacy
claims, no price, no platform badge, no invented slogan, no invented certification, no
new package text and no visual element that could be mistaken as part of the product.
The final image must look like a real product photograph, not an illustration or a fantasy ad.

デフォルトパラメータ：

• SCENE：シンプルで現実的、商品カテゴリに関連するEコマースシーン。
• LIGHTING：柔らかく自然な光。過度な肌の平滑化、露出オーバー、プラスチック感を避けます。
• CAMERA_ANGLE：やや斜め上の3/4アングル。正面と必要な側面が読み取れることを確認します。
• アスペクト比は優先的に 1:1。詳細ページの横向き画像では 4:5 または 3:4 を使用できます。
• デフォルトの解像度は 2k。クライアントから明確に要求された場合のみ、より高い解像度を使用します。

出力ファイル名：02_ecommerce_hero.png。

6. Eコマース画像チェック

確認事項：商品は元の商品のままであること。パッケージテキストが変更されていないこと。シーンが効能を示唆していないこと。価格、プラットフォームのバッジ、架空の認証、誇大広告がないこと。構図がEコマースのサムネイルと詳細ページに適していること。明らかなAI生成の痕跡がないこと。

出力契約

以下を納品するのみ：

OUTPUT_DIR/
├── 01_white_bg_preserved.png
└── 02_ecommerce_hero.png

いずれかの段階で失敗した場合、失敗理由、失敗した画像のパス、および次の修正手順を出力します。不合格の画像は納品しません。

結果の説明は3行のみを保持します：

元画像：<ファイル名>
結果：白背景保真図 <パス>；Eコマースヒーロー画像 <パス>
チェック：商品ID/パッケージテキスト/構造比率を確認済み；<合格または再作業が必要な理由>

禁止事項

• 元の商品を別の商品に美化しない。
• パッケージテキスト、ブランド、商標、承認番号、仕様、価格を無断で修正または補完しない。
• スタイル参照画像を商品事実画像として扱わない。
• 医薬品、健康食品、医療関連商品に対して、効能、治癒、絶対的な表現、または提供されていない宣伝文句を追加しない。
• APIMart API Keyを漏洩しない。キーをスキル、ログ、画像メタデータ、クライアント文書に書き込まない。
• 保真チェックを迂回しない。白背景画像が合格しない場合は、Eコマース画像の生成を続行しない。