| name | sume-ads |
| description | Use Sume Paid Ads, avatar, and Face Swap tools to create ad videos, talking-head or UGC videos, and avatar-based face swaps. Use when the user asks for ads, avatars, spokesperson videos, UGC ads, or replacing a person in a source video with an avatar. |
Sume Ads And Face Swap
Use this skill for Paid Ads video generation, avatar discovery, and Face Swap workflows. Exact inputs come from sume tools schema.
Discovery
sume tools schema avatars.list --json
sume tools schema avatars.get --json
sume tools schema ads.videos.create --json
sume tools schema face-swap.create --json
sume tools schema uploads.presign --json
For MCP clients:
sume mcp
sume mcp --toolsets ads,face-swap --allow-paid
sume mcp --toolsets uploads --allow-write
sume mcp --toolsets downloads --allow-write
Avatar reads are available by default. Ads and Face Swap creation are paid/provider actions. Source-video uploads are write-gated.
Read references/ads-face-swap-workflows.md before creating paid jobs.
Avatar Selection
sume avatars list --limit 5 --json
sume avatars get <avatar_id_or_slug> --json
Use avatar ids or slugs from public API-visible avatar results.
Paid Ads Video
sume ads videos create --script "short product ad" --ad-format video --wait --json
sume ads videos create --script "talking-head product intro" --ad-format talking_heads --avatar-slug "<avatar_slug>" --wait --json
Ask for explicit paid authorization before creating jobs.
Face Swap
Face Swap requires a Sume media URL for the source video plus one or more avatar ids.
For MCP upload, use uploads.asset_video only for Asset Library videos. For Face Swap source videos, use CLI presign with purpose face_swap_source_video unless a future MCP source-video upload helper is added.
sume uploads presign --purpose face_swap_source_video --file-name source.mp4 --content-type video/mp4 --size-bytes 12000000 --json
sume face-swap create --source-video-url "<media_url>" --avatar-id "<avatar_id>" --duration 6 --wait --json
Treat signed upload URLs and source media URLs as sensitive.
Not For
Do not use this skill for generic prompt-only image/video generation, Brand analysis, Reference Analysis, or Asset Library search.
