Back to Details

muapi-ugc-ads-workflow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

UGC Ads Workflow

UGC广告工作流

Create a User-Generated Content (UGC) video ad by combining a human selfie and a product image, then generating a video script and an animated ad.
Estimated credits: ~180 per run.
通过结合人物自拍照和产品图片，生成视频脚本与动画广告，打造用户生成内容（UGC）视频广告。
预估消耗积分： 每次运行约180积分。

Inputs

输入参数

NameTypeRequiredDefaultDescription
product_name
textyes—The name of the product being advertised (e.g. "Blume SuperBalm in plum").
human_image
image_urlno—A selfie or photo of the human influencer.
product_image
image_urlno—A clear photo of the product.
名称类型是否必填默认值描述
product_name
文本是—广告推广的产品名称（e.g. "Blume SuperBalm in plum"）。
human_image
图片URL否—网红博主的自拍照或照片。
product_image
图片URL否—产品的清晰照片。

Steps

步骤

Phase A — Image Combination

阶段A — 图片合成

If 
{{human_image}}
or 
{{product_image}}
is not provided, ask the user to upload them or offer to generate them.
Once both images are available, submit the plan with ONE step to combine them:
  1. Image Generation — 
    muapi image edit
    (model=
    gpt-image-2-text-to-image
    ):
    • Reference Images: Use both 
      {{human_image}}
      and 
      {{product_image}}
      .
    • Prompt: 
      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.
    • Aspect ratio: 9:16 (vertical for TikTok/Reels/Shorts).
Present the combined image to the user for approval.
如果未提供
{{human_image}}
或
{{product_image}}
，请要求用户上传，或主动提出为其生成。
获取到两张图片后，提交包含一个步骤的合成计划：
  1. 图片生成 — 
    muapi image edit
    (model=
    gpt-image-2-text-to-image
    ):
    • Reference Images: Use both 
      {{human_image}}
      and 
      {{product_image}}
      .
    • Prompt: 
      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的竖屏格式).
将合成后的图片呈现给用户，等待确认。

Phase B — Script & Video Generation

阶段B — 脚本与视频生成

  1. Research & Scripting: Use your web search tools to find details about 
    {{product_name}}
    to understand its key benefits.
  2. Based on the research, craft a UGC-style video script with timestamps, similar to this format:
    (0-2s) Influencer is holding the {{product_name}}, smiling genuinely to the camera. "Okay, so you know how I'm always looking for that perfect everyday product?" (2-7s) Influencer shows the product closer to the camera... "Well, I found it! This {{product_name}} is seriously so good." (7-12s) Influencer uses/applies the product. "It feels amazing and actually works." (12-15s) Influencer smiles, slightly pouts, and casually shrugs or nods in approval. "It’s totally become my go-to. You have to try it!"
  3. Video Generation: Submit the plan using an image-to-video model (e.g. 
    sd-2-omni-reference
    or 
    veo3.1-image-to-video
    ).
    • Reference Image: The combined image from Phase A.
    • Prompt: Use the visual actions from the script you generated. For example: 
      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.
    • Aspect ratio: 9:16
After generating the video, present it along with the written script so the user can record their own voiceover or use a lipsync tool later.
  1. 调研与脚本创作: 使用网络搜索工具查找
    {{product_name}}
    的相关信息，了解其核心卖点。
  2. 根据调研结果，创作带时间戳的UGC风格视频脚本，格式如下：
    (0-2秒) 博主手持{{product_name}}，真诚地对着镜头微笑。 "好吧，你们知道我一直在寻找那款完美的日常必备产品吧？" (2-7秒) 博主将产品凑近镜头展示…… "喏，我找到了！这款{{product_name}}真的太好用了。" (7-12秒) 博主使用/涂抹产品。 "它的质感超棒，而且确实有效。" (12-15秒) 博主微笑，微微噘嘴，随意地耸耸肩或点头表示认可。 "它完全成为了我的心头好。你们一定要试试！"
  3. 视频生成: 使用图片转视频模型（e.g. 
    sd-2-omni-reference
    or 
    veo3.1-image-to-video
    ）提交生成计划。
    • Reference Image: 阶段A生成的合成图片。
    • Prompt: Use the visual actions from the script you generated. For example: 
      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
生成视频后，将视频与书面脚本一同呈现给用户，方便用户后续录制自己的旁白或使用唇形同步工具。

Trigger Keywords

触发关键词

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

Notes for the Executing Agent

执行Agent注意事项

  • This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call 
    muapi
    CLI commands. Use 
    muapi auth configure
    first if 
    MUAPI_API_KEY
    is unset.
  • For model IDs without a CLI alias yet, fall back to the raw endpoint via 
    curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}'
    and poll with 
    muapi predict wait <request_id>
    .
  • Substitute 
    {{input_name}}
    placeholders with the user's actual inputs before issuing each call.
  • 本工作流由LLM编排: 请仔细阅读每个阶段，向用户收集缺失的输入，然后调用
    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}}
    占位符替换为用户的实际输入。