使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/samuraigpt/generative-media-skills --skill muapi-ugc-ads-workflow開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
UGC Ads Workflow
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.
Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
product_name | text | yes | — | The name of the product being advertised (e.g. "Blume SuperBalm in plum"). |
human_image | image_url | no | — | A selfie or photo of the human influencer. |
product_image | image_url | no | — | A clear photo of the product. |
Steps
Phase A — Image Combination
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:
- 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.
Phase B — Script & Video Generation
- Research & Scripting: Use your web search tools to find details about
{{product_name}}to understand its key benefits. - 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!"
- Video Generation: Submit the plan using an image-to-video model (e.g.
sd-2-omni-referenceorveo3.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.
Trigger Keywords
ugc ad, ugc video, influencer ad, product ad video, combine product and human
Notes for the Executing Agent
- This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call
muapiCLI commands. Usemuapi auth configurefirst ifMUAPI_API_KEYis 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 withmuapi predict wait <request_id>. - Substitute
{{input_name}}placeholders with the user's actual inputs before issuing each call.
