SuperAPI AI 工具集

Agent-Media UGC Playbook

智能体与模型

查看项目

更新于 10-16 08:48

技能介绍

用途:这是给智能体使用的操作手册(playbook),目标是在 agent-media 上产出一条完整 UGC 视频。平台只提供一个工具 make_ugc,调用方无需选择子技能,它会自行解析身份并跑完整条流水线。

主要能力:一次 make_ugc 调用可呈现三种形态——一行脚本产出干净的对镜短片段;长脚本配真实人脸(image 或 character)产出无裁剪的多段无缝视频;脚本加 broll_url 加人物/图片产出由人物为素材旁白的评测视频。服务器会自动决定流水线、片段数与时长,并在一个 Temporal 工作流中执行,返回 skill_run_id 供轮询。

使用方式:向 POST https://api.agent-media.ai/v1/skills/make_ugc/run 发起单次请求,Headers 为 Authorization: Bearer $AGENT_MEDIA_API_KEY,JSON 体包含 script,可选 person(文字描述)、image(https 图片或 base64)、character(已存 char_… id 或 character_sheet_url)、name。用 GET /v1/skills/runs/<skill_run_id> 轮询,直到 status 为 succeeded,final_output.video_url 即成品 MP4。

身份与发布:person 用文字描述,image 传照片,character 复用已保存角色;三者全省略则用默认人物。完整独白或 b-roll 评测必须给 image 或 character 提供真实人脸,仅 person 不够。拿到 video_url 后可用 publish-to-social 技能发布到 TikTok/Instagram/X,即 POST /v1/social/publish(CLI:agent-media social publish,MCP:social_publish);用户需先通过 OAuth 连接各平台(/v1/social/connect)。

规则与限制:脚本需原样传完整台词,不要裁剪,make_ugc 会自行分句与控速;传入的图片/视频 URL 必须是公开 https 地址(会被重新托管到 R2);积分按每个片段运行时扣除,人像与角色表准备免费;描述中不要写“selfie”或“phone”,应说“talking to camera”。错误处理:INSUFFICIENT_CREDITS 表示积分不足,应给出 agent-media.ai 账单页链接;make_ugc_needs_face 表示需提供真实人脸;若视频中人物拿手机,去掉含 selfie/phone 的姿态提示或设 pose 为空;步骤若长时间停在 submitted,等 30 秒重试轮询,超过 5 分钟仍卡住则属工作流挂起,联系支持并附 workflow_id。更多细节见 skills/make-ugc/SKILL.md、reference/auth.md、reference/pacing.md、reference/realism-rubric.md。