GIF ステッカーメーカー

ユーザー写真を 4 つのアニメーション GIF ステッカー (Funko Pop / Pop Mart スタイル) に変換します。

スタイル仕様

• Funko Pop / Pop Mart ブラインドボックス 3D フィギュア
• C4D / Octane レンダリング品質
• 白背景、ソフトスタジオライティング
• キャプション：黒テキスト + 白アウトライン、画像下部

前提条件

生成ステップを開始する前に、以下を確認してください：

1. Python venv が有効で、requirements.txt からの依存関係がインストールされている
2. MINIMAX_API_KEY がエクスポートされている（例：export MINIMAX_API_KEY='your-key'）
3. ffmpeg が PATH で利用可能である（ステップ 3 の GIF 変換用）

前提条件が不足している場合は、先にセットアップしてください。3 つすべてが揃わないまま生成を進めないでください。

ワークフロー

ステップ 0：キャプション収集

ユーザーに（ユーザーの言語で）尋ねます：

"ステッカーのキャプションをカスタマイズしたいですか、それはデフォルトを使用しますか？"

• カスタム：4 つの短いキャプション（1～3 語）を収集します。アクションは自動的にキャプションの意味に一致します。
• デフォルト：キャプション表を検出されたユーザー言語で参照します。言語を混ぜないでください。

ステップ 1：4 つの静止ステッカー画像を生成

ツール：scripts/minimax_image.py

1. ユーザーの写真を分析 — 被写体タイプ（人物 / 動物 / オブジェクト / ロゴ）を識別します。
2. 4 つのステッカーそれぞれについて、image-prompt-template.txt からプロンプトを構築し、{action} と {caption} を埋めます。
3. 被写体が人物の場合：--subject-ref <user_photo_path> を渡して、生成されたフィギュアが人物の実際の顔立ちを保持するようにします。
4. 生成（すべての 4 つは独立 — 並行実行）：

python3 scripts/minimax_image.py "<prompt>" -o output/sticker_hi.png --ratio 1:1 --subject-ref <photo>
python3 scripts/minimax_image.py "<prompt>" -o output/sticker_laugh.png --ratio 1:1 --subject-ref <photo>
python3 scripts/minimax_image.py "<prompt>" -o output/sticker_cry.png --ratio 1:1 --subject-ref <photo>
python3 scripts/minimax_image.py "<prompt>" -o output/sticker_love.png --ratio 1:1 --subject-ref <photo>

--subject-ref は人物被写体のみで機能します（API 制限：type=character）。 動物 / オブジェクト / ロゴの場合、フラグを省略して、テキスト説明に頼ります。

ステップ 2：各画像をアニメーション化 → ビデオ

ツール：scripts/minimax_video.py に --image フラグ付き（画像からビデオモード）

各ステッカー画像について、video-prompt-template.txt からプロンプトを構築し、以下を実行します：

python3 scripts/minimax_video.py "<prompt>" --image output/sticker_hi.png -o output/sticker_hi.mp4
python3 scripts/minimax_video.py "<prompt>" --image output/sticker_laugh.png -o output/sticker_laugh.mp4
python3 scripts/minimax_video.py "<prompt>" --image output/sticker_cry.png -o output/sticker_cry.mp4
python3 scripts/minimax_video.py "<prompt>" --image output/sticker_love.png -o output/sticker_love.mp4

すべての 4 つの呼び出しは独立 — 並行実行。

ステップ 3：ビデオを GIF に変換

ツール：scripts/convert_mp4_to_gif.py

python3 scripts/convert_mp4_to_gif.py output/sticker_hi.mp4 output/sticker_laugh.mp4 output/sticker_cry.mp4 output/sticker_love.mp4

各 MP4 の隣に GIF ファイルを出力します（例：sticker_hi.gif）。

ステップ 4：配信

出力形式（厳密な順序）：

1. 簡潔なステータス行（例：「4 つのステッカーを作成：」）
2. すべての GIF ファイル含む <deliver_assets> ブロック
3. deliver_assets の後はテキストなし

<deliver_assets>
<item><path>output/sticker_hi.gif</path></item>
<item><path>output/sticker_laugh.gif</path></item>
<item><path>output/sticker_cry.gif</path></item>
<item><path>output/sticker_love.gif</path></item>
</deliver_assets>

デフォルトアクション

#	アクション	ファイル名 ID	アニメーション
1	楽しそうに手を振る	hi	手を振る、軽く首を傾ける
2	大笑い	laugh	笑いで揺れ、目を細める
3	涙を流す	cry	涙が流れ、体が震える
4	ハートジェスチャー	love	ハート形の手、目がキラキラ

多言語キャプションのデフォルトについては、references/captions.md を参照してください。

ルール

• ユーザーの言語を検出し、すべての出力はそれに従う
• キャプションは必ず captions.md からユーザーの言語列に一致するものを使用 — 言語を混ぜない
• すべての画像プロンプトは、ユーザー言語に関係なく 英語 である必要があります（キャプションテキストのみローカライズ）
• <deliver_assets> は応答の最後である必要があり、その後にテキストはなし