用途:输入一段脚本(script,长度不限),即可得到一条完成的竖屏 UGC 视频。脚本是短句时生成单个口播片段,是整段独白时自动生成多镜头无缝拼接的完整视频,不会被裁剪。也可用 scene_action 生成无声片段(需搭配角色)。
主要能力:可选择由谁出镜,方式最多选一种——person(文字描述)、image(人物照片的 https 公开链接或 base64,面部锁定为该照片)、character(复用已保存角色的 char_… id 或 character_sheet_url);name 为可选提示。支持 look(natural | commercial | raw_iphone)、aspect_ratio(9:16 | 1:1)、broll_url(以 https 视频叠加在下半部分并配旁白)、duration(留空由脚本推断长度)。字幕为可选,默认关闭,需先询问用户是否要字幕及 caption_style(hormozi | tiktok | minimal),确认后才设 captions:true。长独白或 broll_url 口播需要真实面孔,应传 image 或 character,而非仅 person。
使用方式:首选 MCP 工具 mcp__agent-media__make_ugc;备选为 REST:POST https://api.agent-media.ai/v1/skills/make_ugc/run,需 Authorization: Bearer $AGENT_MEDIA_API_KEY、Content-Type: application/json 与 Idempotency-Key。轮询结果:GET https://api.agent-media.ai/v1/skills/runs/<skill_run_id>,返回各步骤状态与 current_step,成功后 final_output.video_url 即成品 MP4。视频完成后角色会被保存,GET /v1/characters 可列出 character_id(char_…)与 character_sheet_url,下一条视频复用可保持同一张脸并更快更省。
适用场景:短视频口播、整段独白、产品评测、broll/游戏画面旁白、需要同一人物跨视频保持一致。视频耗时通常 360–1400 秒,短片段约 190–505 credits,长独白或 broll 按镜头计费。提交后应告知用户计划与预计时间,并轮询播报 current_step。字幕须先征得用户同意;不确定是否沿用同一人物时应先询问。其余细节(如首次安装、登录)暂未在资料中提供。