name: gif-sticker-maker
description: |-
    将照片（人物、宠物、物品、标志）转换为4张带有说明文字的动画GIF贴纸。
    适用场景：用户想要创建卡通贴纸、GIF表情、表情包、动态头像，
    或将照片转换为Funko Pop / Pop Mart盲盒风格动画。
    触发词：贴纸、GIF、卡通、表情、表情包、头像动画。
license: MIT
metadata:
    version: "1.2"
    category: creative-tools
    style: Funko Pop / Pop Mart
    output_format: GIF
    output_count: 4
    sources:
        - MiniMax Image Generation API
        - MiniMax Video Generation API

GIF 贴纸制作器

将用户照片转换为 4 个动画 GIF 贴纸（Funko Pop / Pop Mart 风格）。

风格规格

• Funko Pop / Pop Mart 盲盒 3D 手办
• C4D / Octane 渲染质量
• 白色背景，柔和的工作室灯光
• 字幕：黑色文字 + 白色描边，位于图片底部

前置条件

在开始任何生成步骤之前，请确保：

1. Python venv 已激活，并且已安装 [requirements.txt](references/requirements.txt) 中的依赖项
2. MINIMAX_API_KEY 已导出（例如 export MINIMAX_API_KEY='your-key'）
3. ffmpeg 已加入 PATH（用于步骤 3 的 GIF 转换）

如果缺少任何前置条件，请先完成设置。未满足全部三个条件前，请勿进行生成。

工作流程

步骤 0：收集字幕

以用户的语言询问用户：

"您希望自定义贴纸的字幕，还是使用默认设置？"

• 自定义：收集 4 条短字幕（1–3 个词）。动作会自动匹配字幕含义。
• 默认：根据检测到的用户语言查找 [captions table](references/captions.md)。切勿混合语言。

步骤 1：生成 4 张静态贴纸图片

工具：scripts/minimax_image.py

1. 分析用户的照片 — 确定主体类型（人 / 动物 / 物体 / 标志）。
2. 对于 4 张贴纸中的每一张，根据 [image-prompt-template.txt](assets/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](assets/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

输出 GIF 文件与每个 MP4 在同一目录下（例如 sticker_hi.gif）。

步骤 4：交付

输出格式（严格顺序）：

1. 简短状态行（例如 "已创建 4 张贴纸："）
2. <deliver_assets> 块，包含所有 GIF 文件
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>

默认动作

查看 [references/captions.md](references/captions.md) 获取多语言默认字幕。

规则

• 检测用户语言，所有输出遵循该语言
• 字幕必须来自 [captions.md](references/captions.md) 中与用户语言列匹配的内容 — 切勿混合语言
• 所有图片提示词必须使用英文，无论用户语言为何（只有字幕文本本地化）
• <deliver_assets> 必须是响应中的最后内容，之后无文字