用途:将已完成的广告创意(视频或图片)发布到 Goose Ads 示例库,并在来源于真实广告构建时填写 remix payload,使示例不只是静态展示,而能在应用中被重新混剪。这也是添加新示例的标准方式,管理面板底层使用相同接口。该技能由智能体执行,无外部脚本,用 curl 或其他 HTTP 客户端内联完成上传与登记。写入接口要求 API token 所属用户在管理员允许列表中,普通用户 token 会返回 403。
主要能力:支持本地文件或已托管 URL 两种上传路径;可设置标题、格式、比例、品牌、标签、是否发布、是否首页推荐、是否可混剪、排序、slug 等;视频格式可传 format_key 与 thread_json 生成混剪 recipe,并自动从会话线程提取 extracted_script;Meta UGC 广告可基于 content-goose 项目生成结构化 remix_spec。
使用方式:环境变量按 $GOOSEWORKS_API_BASE_URL、$GOOSEWORKS_API_URL 顺序解析,默认 https://app.gooseworks.ai,认证用 $GOOSEWORKS_API_TOKEN。本地文件流程为三步:请求预签名 PUT URL、PUT 文件字节(必须带上返回的 content-type 与 cache-control 头,否则 S3 返回 403)、用 media_url 登记示例。已托管媒体可直接登记。视频必须提供 thumbnail_url,缺失时可用 ffmpeg 抽帧并上传。UGC 广告先调用 parse-remix-spec 解析生产 JSON,再随登记请求一次性提交。
适用场景:视频或图片创意完成并获准公开展示;需要让示例进入首页广告网格;需要使视频格式或 Meta UGC 广告可被混剪。
限制:预签名 URL 15 分钟过期;代理上传接口限 250 MB;recipe 须为 JSON 对象且序列化不超过 64 KB;skills 与 skills_used 只能用原子技能 slug,不能用 molecule;403 表示 token 未被管理员允许。部分字段默认值与内部流程细节以资料为准,未在此展开。