SuperAPI AI 工具集

animate-image

设计与创作

查看项目

更新于 10-27 11:26

技能介绍

Animate Image 是一项通过 GooseWorks 将现有产品图片或静态广告转化为短视频创意的技能。它使用与 Animate Images 界面相同的后端工作流,适合需要为已有静态素材添加动态效果的场景。

用途 该技能的核心用途是把一张静态的产品图或广告图变成一段短小的动态创意视频。它保留了源图像的连续性,适合产品展示、广告投放等需要快速生成动态素材的场合。

前提条件 使用该工作流需要 GooseWorks MCP 连接器(https://mcp.gooseworks.ai/mcp)。它依赖三个工具:ads_creative_animation_quote(免费报价)、ads_creative_animate(付费启动)和 job_get(轮询)。部分客户端按组列出工具,只有在加载 ads 组后才会显示相关工具。如果工具列表中找不到 ads_creative_animation_quote 或 ads_creative_animate,需要先调用 tools_load 并传入 { "groups": ["ads"] }(免费)。如果工具仍然缺失,或者 account_whoami 返回 features.animate_image: false,则说明连接或功能不可用,应停止操作,不要用无关的图像生成器替代。

工具调用 流程分为三步:

  1. 报价:调用 ads_creative_animation_quote。该调用免费且只读,不获取也不预留任何资源,返回 { dry_run: true, estimate: { frame, duration_seconds, model, estimated_credits } }。
  2. 启动:调用 ads_creative_animate。该调用付费,会预留积分并启动任务,返回 { job_id, kind: "animate", status }。
  3. 轮询:调用 job_get,传入 { job_id, kind: "animate" }。该调用只读。当状态为 complete 时,result.output_url 保存视频;出错时 error 会说明失败原因。

ads_creative_animation_quote 和 ads_creative_animate 接受相同的载荷: { "brand_id": "<brand id from brand_read>", "creative_id": "<ad creative id from ads_creative_read or ads_save>", "animate": { "source_render_id": "<render id, or null>", "source_image_url": "<public https URL of the still>", "frame": "end", "prompt": "<motion prompt>", "duration_seconds": 5 } }

creative_id 是动画所属的广告创意。优先使用已有的渲染(source_render_id 及其 URL 作为 source_image_url),以保留来源信息。 frame 可以是 "start"(静态图作为开场帧)或 "end"(静态图作为结束帧,默认值)。两者消耗的积分可能不同;报价会显示所传 frame 对应的价格。 duration_seconds 必须是 5 或 10,其他值会被拒绝。 启动需要代理范围的令牌或账户上的默认代理;否则工具会返回 agent_required。

工作流程

  1. 用 brand_read 解析品牌(省略 brand_id 可列出品牌)。然后找到静态图:
    • 已有广告:用 ads_creative_read(包含渲染)读取,获取 creative_id、source_render_id 和渲染 URL。
    • 尚未进入 GooseWorks 的普通图片:用 media_upload 上传到该品牌下,然后用 ads_save 保存为广告创意(传入 media_id;免费)。ads_save 返回 creative_id、render_id 和 output_url,分别用作 creative_id、source_render_id 和 source_image_url。
  2. 明确运动目标、时长(5 或 10 秒),以及用户希望源图作为起始帧还是结束帧。
  3. 编写运动提示词,描述镜头运动、主体运动、环境运动、节奏以及必须保持不变的内容。不要重新设计产品,也不要添加无依据的声明。
  4. 调用 ads_creative_animation_quote,并按工具返回的原样向用户展示 estimated_credits。切勿将其换算为美元或自行计算。询问用户是否同意该积分数量。
  5. 用户同意后,用相同载荷调用一次 ads_creative_animate。保存返回的 job_id。
  6. 每隔几秒用 kind: "animate" 轮询 job_get,直到状态为 complete 或 failed。任务运行期间切勿再次启动同一动画;第二次启动会再次付费。
  7. 返回 result.output_url 和所使用的源图。如果失败,先用通俗语言报告错误,再提议重试。

规则

  • 消耗积分前必须询问。报价免费;每次 ads_creative_animate 调用都是付费生成。
  • 未经用户明确同意报价积分,绝不启动。
  • 金额就是报价返回的积分数字,绝不显示美元。
  • 除非用户明确要求更改,否则保留产品形状、标志、包装和图上文字。
  • 对于产品图和图形广告,优先使用细微、物理上合理的运动。
  • 为已在运行的任务提交新提示词属于新的付费生成;需要重新报价并再次询问。

适用场景 适合已有产品图片或静态广告、希望快速生成带品牌感的短视频素材的用户。可用于产品展示、广告创意动态化等场景。

限制

  • 需要 GooseWorks MCP 连接器,且账户需启用 animate_image 功能。
  • 时长仅支持 5 秒或 10 秒。
  • 启动需要代理范围的令牌或默认代理。
  • 付费生成前必须获得用户对积分报价的明确同意。
  • 不得将积分换算为美元。
  • 不得用无关的图像生成器替代。
  • 关于具体价格、支持的模型、输出分辨率、平台兼容性等信息,资料中暂未提供。