make-b-roll-talking-head

name	Make B-roll Talking Head
description	Up-to-30s vertical talking-head video: the actor speaks full-frame while a user-supplied b-roll video is overlaid on the lower half. <=15s renders as a single take (zero cuts); 16-30s uses two takes where the voice, face and setting carry across the cut automatically (take 1's voice and final frame seed take 2) — consistent speaker and continuous scene, not a jump-cut. Provide actor_image_url (any https image) + broll_video_url (any https video — both re-hosted to R2 automatically) and EITHER script (Seedance voice) OR audio_url (your own audio, single clip <=15s). Optional: subtitles; broll_width_rate (0.1-1.0, e.g. 0.8 = b-roll 80% width centered with black margins; omit for full width); broll_start_time (seconds before the b-roll appears); broll_fade_out (dissolve the b-roll at its end).
allowed-tools	["mcp__agent-media__make_broll_talking_head"]
x-skill-slug	make_broll_talking_head
x-skill-version	1.1.0
x-primitive	composed:broll_talking_head
x-mcp-tool	mcp__agent-media__make_broll_talking_head

Make B-roll Talking Head

Up-to-30s vertical talking-head video: the actor speaks full-frame while a user-supplied b-roll video is overlaid on the lower half. <=15s renders as a single take (zero cuts); 16-30s uses two takes where the voice, face and setting carry across the cut automatically (take 1's voice and final frame seed take 2) — consistent speaker and continuous scene, not a jump-cut. Provide actor_image_url (any https image) + broll_video_url (any https video — both re-hosted to R2 automatically) and EITHER script (Seedance voice) OR audio_url (your own audio, single clip <=15s). Optional: subtitles; broll_width_rate (0.1-1.0, e.g. 0.8 = b-roll 80% width centered with black margins; omit for full width); broll_start_time (seconds before the b-roll appears); broll_fade_out (dissolve the b-roll at its end).

When to use this

Call this skill when the user asks for the outcome described above. It runs on the agent-media vNext primitive runtime via the mcp__agent-media__make_broll_talking_head MCP tool. Authentication is the user's existing agent-media Bearer token (issued by agent-media login).

How to call it

Preferred path: MCP tool mcp__agent-media__make_broll_talking_head. Schema is auto-published via tools/list against the same MCP server, so don't restate the schema here — trust the server's response.

Fallback path: REST.

POST https://api.agent-media.ai/v1/skills/make_broll_talking_head/run
Authorization: Bearer $AGENT_MEDIA_API_KEY
Content-Type: application/json
Idempotency-Key: <any unique string per intent>

What it costs and how long it takes

• Credits: ?
• Wall time (typical): ?s
• Deducted at submit; refunded on terminal failure.

Polling the result

GET https://api.agent-media.ai/v1/skills/runs/<skill_run_id>
Authorization: Bearer $AGENT_MEDIA_API_KEY

Returns per-step status with intermediate artifact URLs as each primitive completes.

House rules baked into this skill

• See reference/realism-rubric.md for the realism doctrine baked into every prompt.
• See reference/auth.md for first-time install and agent-media login.

Source of truth

This file is auto-generated by scripts/generate-public-skill.ts from the registry at services/api-v2/src/skills/registry.ts. Do not hand-edit; CI rejects drift.