muapi-ugc-ads-workflow

UGC 广告工作流

将真人自拍与产品图片结合，生成视频脚本和动画广告，打造用户生成内容（UGC）视频广告。

输入

名称	类型	必填	默认值	描述
product_name	text	是	—	所推广产品的名称（例如 “Blume SuperBalm in plum”）。
human_image	image_url	否	—	人类网红的自拍或照片。
product_image	image_url	否	—	清晰的产品照片。

步骤

阶段 A — 图片合成

如果未提供 {{human_image}} 或 {{product_image}}，请让用户上传图片，或提出为其生成图片。

两张图片都准备好后，提交仅包含一个步骤的计划来合成图片：

1. 图片生成 — muapi image edit（model=gpt-image-2-text-to-image）：
   • 参考图片：使用 {{human_image}} 和 {{product_image}}。
   • 提示词：A natural, candid UGC-style photo of the influencer from the first reference image holding and showcasing the product from the second reference image. The influencer is smiling genuinely at the camera, holding the product up. Natural indoor lighting, lifestyle aesthetic, high quality.
   • 宽高比：9:16（适用于 TikTok/Reels/Shorts 的竖版比例）。

将合成图片展示给用户确认。

阶段 B — 脚本与视频生成

1. 调研与脚本编写：使用网络搜索工具查找 {{product_name}} 的相关信息，了解其主要优势。

2. 根据调研结果，编写带时间戳的 UGC 风格视频脚本，格式类似如下：

   (0-2s) 网红手持 {{product_name}}，对着镜头真诚地微笑。 “好吧，你知道我一直在找那种完美的日常用品吧？” (2-7s) 网红将产品拿近镜头展示…… “我找到了！这款 {{product_name}} 真的太好用了。” (7-12s) 网红使用／涂抹产品。 “感觉特别好，而且确实有效。” (12-15s) 网红微笑、微微噘嘴，并随意地耸耸肩或点头表示赞许。 “它完全成了我的必备品。你一定要试试！”

3. 视频生成：使用图生视频模型（例如 sd-2-omni-reference 或 veo3.1-image-to-video）提交计划。

   • 参考图片：阶段 A 合成的图片。
   • 提示词：使用你生成的脚本中的视觉动作。例如：A UGC-style video. The influencer holds the {{product_name}}, smiling genuinely. She brings it closer to the camera to show the label, then applies it smoothly. She nods in approval and smiles. Natural movements, talking to the camera, lifestyle vlog style.
   • 宽高比：9:16

生成视频后，将视频和书面脚本一并展示给用户，供其录制自己的旁白或之后使用口型同步工具。

触发关键词

ugc ad、ugc video、influencer ad、product ad video、combine product and human

---

执行 Agent 注意事项

• 此方案由大模型编排：阅读每个阶段的说明，向用户收集所有缺失的输入，然后调用 muapi CLI 命令。如果未设置 MUAPI_API_KEY，请先运行 muapi auth configure。
• 对于尚无 CLI 别名的模型 ID，请通过 curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' 调用原始端点，并使用 muapi predict wait <request_id> 轮询。
• 每次调用前，将 {{input_name}} 占位符替换为用户的实际输入。