mcpField
G
gif-sticker-maker

gif-sticker-maker

github.com/minimax-aiクリエイティブ・メディア13.7k2.0k 回インストール28 週間前に更新
リポジトリ

gif-sticker-maker について

gif-sticker-makerは、ユーザーの写真からブラインドボックス風の3Dフィギュアを使ったアニメーションGIFステッカーを4点作るスキルです。画像生成、アニメーション化、GIF変換を行い、ユーザーの言語に合わせた字幕を設定できます。

主な機能

  1. 013Dフィギュア風ステッカー画像を4点生成
  2. 02静止ステッカー画像をアニメーション化
  3. 03MP4ファイルをGIFに変換
  4. 04人物の顔の特徴を反映
  5. 05字幕の選択またはカスタマイズ

活用シーン

  1. 01人物写真からリアクションステッカーを作成
  2. 02ペットや物の写真をアニメーションステッカー化
  3. 03ユーザーの言語で短い字幕を追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/minimax-ai/skills --skill gif-sticker-maker

インストール後、Claude Code で/gif-sticker-makerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
image-prompt-template.txt
video-prompt-template.txt
references/
captions.md
requirements.txt
scripts/
convert_mp4_to_gif.py
minimax_image.py
minimax_video.py

詳細

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語）収集します。アクションはキャプションの意味に合わせて自動的に選びます。
  • デフォルト：検出したユーザーの言語に対応するcaptions tableを参照します。言語を混在させないでください。
ステップ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：各画像を動画にアニメーション化する

ツール：画像から動画への変換モードで--imageフラグを指定したscripts/minimax_video.py

各ステッカー画像について、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>は応答の最後に置き、その後にはテキストを追加しないでください

コメント

Markdown 対応