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 转换）

若任一前置条件未满足，请先完成配置。**未满足全部三项条件前，禁止进入生成流程。**

工作流

第 0 步：收集文字说明（Caption）

向用户提问（使用其本地语言）：

“您希望自定义贴纸上的文字说明，还是使用默认文案？”

• 自定义模式：收集 4 条简短文字说明（每条 1–3 个词）。动作类型将自动匹配对应文案语义。
• 默认模式：根据检测到的用户语言查表获取默认文案（见 references/captions.md）。严禁混用多种语言。

第 1 步：生成 4 张静态贴纸图像

工具：scripts/minimax_image.py

1. 分析用户照片，识别主体类型（人物 / 动物 / 物体 / Logo）。
2. 针对每张贴纸，基于 image-prompt-template.txt 填充 {action} 和 {caption} 生成完整提示词。
3. 若主体为人像：需传入 --subject-ref 参数，以确保生成的手办保留该人物真实面部特征。
4. 执行生成（4 次调用相互独立 —— 请并发运行）：

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

--subject-ref 仅对人物主体生效（API 限制：type=character）。 对于动物 / 物体 / Logo，请省略该参数，完全依赖文本描述生成。

第 2 步：将每张图像动画化 → 视频

工具：scripts/minimax_video.py，配合 --image 标志（启用图像转视频模式）

对每张贴纸图像，基于 video-prompt-template.txt 构建提示词，然后执行：

python3 scripts/minimax_video.py "" --image output/sticker_hi.png -o output/sticker_hi.mp4
python3 scripts/minimax_video.py "" --image output/sticker_laugh.png -o output/sticker_laugh.mp4
python3 scripts/minimax_video.py "" --image output/sticker_cry.png -o output/sticker_cry.mp4
python3 scripts/minimax_video.py "" --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 文件路径
3. deliver_assets 后不得有任何额外文本

output/sticker_hi.gif
output/sticker_laugh.gif
output/sticker_cry.gif
output/sticker_love.gif

默认动作列表

多语言默认文案详见 references/captions.md。

规则

• 须检测用户语言，所有输出内容（含文案、提示词外显文本）均须遵循该语言
• 文字说明（Caption）必须严格来自 captions.md 中与用户语言对应的列 —— 禁止混用语言
• 所有图像生成提示词（prompt）必须使用英文（仅 caption 文本可本地化）
• 必须为响应中最后一部分内容，其后不得出现任何文本