用途:在 agent-media 上由智能体(Claude、Cursor 或自定义)产出成品 UGC 视频。平台只有一个工具 make_ugc,无需选择子技能,它内部完成身份解析并跑完整条流水线。
主要能力:支持三种形态——短片段(一行脚本,可选人物/图片/角色,输出单条口播片段);完整独白(长脚本加真实人脸,输出无缝多镜头视频,不裁剪);旁白解说(脚本加 broll_url 加角色或图片,人物在你的素材上配音)。
使用方式:单次调用 POST https://api.agent-media.ai/v1/skills/make_ugc/run,请求头 Authorization: Bearer $AGENT_MEDIA_API_KEY,请求体含 script,可选 person、image、character、name。返回 skill_run_id,用 GET /v1/skills/runs/<skill_run_id> 轮询,直到 status 为 succeeded,final_output.video_url 即成品 MP4。发布可选:拿到 video_url 后可用 publish-to-social 技能 POST /v1/social/publish(CLI agent-media social publish,MCP social_publish)发到 TikTok、Instagram、X,用户需先通过 /v1/social/connect 完成 OAuth 连接。
身份参数:person 用文字描述;image 为照片(https URL 或 base64);character 为已保存的 char_… id 或 list_characters 返回的 character_sheet_url;三者都省略则用默认人物。完整独白或旁白解说需要真实人脸,必须传 image 或 character,仅 person 不够。复用已保存角色时下次调用传同一 character,无需重新生成。
规则与限制:make_ugc 自行处理脚本节奏与分段,应传完整台词或独白,不要裁剪,长度由脚本推断。传入的图片/视频 URL 必须是公开 https 地址(make_ugc 会重新托管到 R2),或使用 character_sheet_url / char_…。积分按每个镜头运行扣除,竖版人像与角色表准备免费,只为视频本身付费。描述中不要写 selfie 或 phone,应写 talking to camera。
故障排查:INSUFFICIENT_CREDITS 表示积分不足,应给出 agent-media.ai 计费页链接;make_ugc_needs_face 表示需要 image 或 character;视频中人物拿手机说明姿势提示含 selfie 或 phone,需去掉或设 pose 为空;步骤卡在 submitted 可能是 Temporal worker 重启,等 30 秒重试,超过 5 分钟仍卡住则联系支持并提供 workflow_id。
适用场景:需要批量或自动化生成口播类 UGC 视频并可直接发布到社交平台的智能体工作流。
限制:具体价格、积分额度、支持平台细节及完整字段手册未在资料中提供,需查阅 skills/make-ugc/SKILL.md 等参考文档。