用途:根据角色参考图和产品图,生成5、10或15秒的竖版UGC视频,画面中的角色会手持、穿戴并展示该产品。
主要能力:提供两种模式——script用于带唇形同步的口播产品评测(语速约2-4词/秒),scene_action用于无声演示或b-roll。可设置subject(如“a young woman”)锁定人物性别与外观,避免性别化产品造成人物漂移;framing可选close_up(胸部以上,默认)或full_body(全身,适合转身或展示整套穿搭)。人物与具体产品均从参考图锁定。
使用方式:需提供character_sheet_url(R2托管)和产品图,产品图可用product_image_url(任意https URL)或product_image_base64,后者会自动重新托管到R2。优先通过MCP工具mcp__agent-media__make_product_in_hands调用,其schema由服务端tools/list自动发布;备用REST方式为POST https://api.agent-media.ai/v1/skills/make_product_in_hands/run,请求头带Authorization: Bearer $AGENT_MEDIA_API_KEY、Content-Type: application/json及Idempotency-Key。鉴权使用用户已有的agent-media Bearer令牌(由agent-media登录签发)。提交后可用GET https://api.agent-media.ai/v1/primitives/runs/<run_id>轮询结果。
适用场景:需要让虚拟角色展示产品的短视频、口播评测或静默产品演示。
限制:积分消耗与典型耗时资料中均标注为“?”,暂未提供;积分在提交时扣除,终端失败时退还。首次安装与登录说明见reference/auth.md,提示词中的真实感规则见reference/realism-rubric.md。