機能概要
システムの主要機能 #
テーマ画像システムはAIで多様なスタイルの商品画像を自動生成し、テーマ切替・スケジュールキャンペーン・プラットフォーム同期に対応します:
AIバッチ画像生成
生成方式 #
2つのAI画像生成サービスに対応、設定に応じて自動選択されます:
| サービス | 説明 | 特徴 |
|---|---|---|
| Gemini API | Google Gemini大規模モデルによる画像生成 | 高品質、APIキーとウォレット残高が必要 |
| BizAI リモートサービス | BizRobot無料AI画像生成サービス | 無料、バッチ処理(3枚ずつ、5秒間隔) |
操作手順 #
| ステップ | 操作 |
|---|---|
| ステップ1 | 商品詳細ページ →「商品主画像」タブを開く |
| ステップ2 | ベースとなる商品画像を1枚アップロード |
| ステップ3 | 「バッチ画像生成」をクリック、新しいテーマタスクを作成 |
| ステップ4 | 各画像にロール記述を設定(例:クリスマス雰囲気、雪景色背景など) |
| ステップ5 | 生成実行、AIが記述に基づいて複数スタイルの画像を自動生成 |
ロール記述(バッチロール) #
各テーマタスクには複数のロール記述を含めることができ、1つの記述が1枚の生成画像に対応します:
- 順序:画像の並び順
- ロール記述:AIにどのスタイルの画像を生成するか指示(例:「暖かいクリスマスの雰囲気を背景に、クリスマスツリーと雪の結晶の装飾を追加」)
- 商品に適用:チェックすると、この画像が商品主画像に適用されます
テーマ切替管理
画像追加生成
機能説明 #
既存テーマの画像数が不足、または新しいスタイルを追加したい場合、「追加生成」機能を使用できます。全画像を再生成する必要はありません:
- テーマタグコンポーネントで「追加生成」ボタンをクリック
- ポップアップウィザードで新画像のロール記述を入力
- システムが自動的にGemini APIまたはBizAIリモートサービスを選択
- 生成完了後、新画像が現在のテーマに自動追加
- 現在のテーマがアクティブ状態の場合、新画像は自動的に商品に適用
マルチ画像スタイル変換
機能説明 #
マルチ画像スタイル変換は、商品の既存の全画像(主画像+詳細画像)を一括でスタイル変換する機能です。元画像の内容を保持したまま、統一されたスタイルに変更できます。
| 通常バッチ生成 | マルチ画像スタイル変換 | |
|---|---|---|
| 入力画像 | 商品原画1枚 | 商品の全画像(主画像+詳細画像) |
| 生成記述 | 複数のロール記述 | 1つのスタイル記述 |
| 出力結果 | N枚の異なる内容の画像 | N枚の統一スタイル、元画像と1対1対応する画像 |
操作手順 #
| ステップ | 操作 |
|---|---|
| ステップ1 | 商品詳細ページ →「商品主画像」タブ →「バッチ画像生成」をクリック |
| ステップ2 | 「マルチ画像スタイル変換」 スイッチをON |
| ステップ3 | スタイル記述を編集(デフォルト:元画像の内容を保持し、画像スタイルのみ変更) |
| ステップ4 | 「画像生成」または「無料 biz AI生成」をクリック |
| ステップ5 | 「バッチ生成結果」タブで結果を確認、各画像名は元画像に対応 |
スタイル記述の例 #
- 「元画像の内容を保持し、画像スタイルのみ変更」(デフォルト)
- 「水彩画風に変換」
- 「クリスマスの装飾要素を追加、商品本体を保持」
- 「シンプルなフラットデザイン風に変換」
- 「桜の季節の雰囲気を追加、色調をピンク系に」
プリアップロードとキャッシュ
プリアップロード機能 #
テーマタグコンポーネントの「プリアップロード」ボタンをクリックすると、現在のテーマの全画像を商品に紐付けられた全プラットフォーム店舗に事前アップロードできます。
| メリット | 説明 |
|---|---|
| 切替高速化 | キャンペーン開始時にキャッシュ済みの画像パスを直接使用、アップロード待ち不要 |
| 重複回避 | 各プラットフォームのアップロードパス(Cabinetパス)を自動キャッシュ、同一画像の重複アップロードを防止 |
| 非同期処理 | キュージョブ(queue_job)で非同期実行、同時リクエスト数は3に自動制限 |
キャンペーン作成
操作手順 #
- 商品詳細ページ → 「商品主画像」タブを開く
- 「バッチ画像生成」で作成済みのテーマがあることを確認(例:クリスマステーマ、お正月テーマなど)
- 「画像キャンペーン」タブ → 「作成」をクリック
- 以下の情報を入力:
- キャンペーン名 — 例「2026年お正月キャンペーン」
- キャンペーンテーマ — 完成済みのバッチ生成テーマを選択
- 適用モード — 全置換 または テーマ画像優先
- 開始時間 — キャンペーンが自動開始する時間
- 終了時間 — キャンペーンが自動終了する時間
- 保存後、ステータスは「下書き」となり、スケジュールタスクによる自動開始を待ちます
キャンペーンフロー
適用モード
2つの画像適用モード #
| モード | 説明 | 適用シーン |
|---|---|---|
| 全置換 | テーマ画像で全ての商品画像を完全に置換 | 季節テーマに完全切替したい場合 |
| テーマ画像優先 | テーマ画像を先頭に配置し、初期画像を後ろに残す | 元の画像を残しつつキャンペーンバナーを追加したい場合 |
自動スケジュール
スケジュールタスクについて #
システムは 10分 ごとにキャンペーンのステータスを自動チェックします:
- 開始時間に達した下書きキャンペーン → 自動開始
- 終了時間に達した進行中キャンペーン → 自動終了
- 中間ステータスで停止した(開始中/終了中)キャンペーン → 自動復旧
よくある質問
Q: AI画像生成が失敗した場合は? #
A: Gemini APIを使用している場合、ウォレット残高とAPIキーの有効性を確認してください。無料のBizAIリモートサービスへの切替も可能です。
Q: テーマを切り替えるには? #
A:「商品主画像」タブのテーマタグコンポーネントで、切り替えたいテーマタグをクリックするだけでワンクリック切替できます。紫色のタグが現在アクティブなテーマです。
Q: 追加生成した画像が商品に表示されません #
A: 追加生成はバックグラウンドスレッドで実行されます。しばらく待ってからページを更新してください。テーマがアクティブ状態であれば、新画像は自動適用されます。
Q: キャンペーンテーマのドロップダウンが空です #
A:「商品主画像」タブで「バッチ画像生成」機能を使用して、少なくとも1つのテーマを作成・完了する必要があります。
Q: キャンペーン終了後に画像が復元されません #
A: 商品に「初期画像バックアップ」があるか確認してください。テーマタグコンポーネントの「初期画像」ボタンで手動復元もできます。
Q: 1つの商品に複数のキャンペーンを設定できますか? #
A: はい、ただし期間は重複できません。システムが自動的に期間の重複をチェックします。
Q: プリアップロードのメリットは? #
A: プリアップロードにより画像が各プラットフォーム(Cabinetパス)にキャッシュされ、キャンペーン開始時にキャッシュを直接使用して切替遅延を大幅に削減します。キャンペーン前の実行をお勧めします。
Q: マルチ画像スタイル変換と通常バッチ生成は切替可能ですか? #
A: はい。バッチ生成ダイアログで「マルチ画像スタイル変換」のスイッチをON/OFFするだけで切替できます。OFFにするとロールリストと原画アップロードエリアが再表示されます。どちらのモードで生成した結果もテーマとして商品に適用可能です。
