SuperAPI AI 工具集

render-street-interview

营销与增长

查看项目

更新于 10-28 12:11

技能介绍

用途:render-street-interview 是面向街访广告格式的渲染技能,用完整核查过的商业交互记录和当前品牌事实来撰写街访广告。资料标注它已被 goose-studio 的 street-interview 视频套件取代,其配方在 goose-studio 中退役,但渲染器行为保持不变,因为 write-video-ad-script 技能会调用它的脚本上下文步骤,其脚本仍可运行。

主要能力: 一、交互类型。共四种:product-guess(产品猜测)保留可见物体与揭示,现有物体渲染器,需要独立的商品参考图,最多 4 名参与者,禁止人物图像参考;mic-only(仅麦克风对话),预览服务类讲解,无产品与设备,禁止人物图像参考,1 人;product-sample(准备样品),普通杯子中装有准备样品,不绑定确切包装,禁止人物图像参考,1 人;concept-challenge(概念挑战),用非 UI 道具描述的可见任务,禁止人物图像参考,1 人。 二、脚本准备。prepare_script_context.py 需要一份 brief,含 offering_type=physical|service|digital 与 interaction_type。必须先选定连贯情境和自然成立的广告关联,再写台词。要检查完整视觉时间线与口播交流:设置、参与理由、钩子、产品角色与回报。未见到的招募或设置记为未知,推断不等于观察;种子片段只是线索,广播与编辑类交流不能填补街访缺口。 三、参与者数。需传入 participants,即在屏幕上接受采访的人数(不含采访者),product-guess 默认 4,对话类默认 1。其路由输出对该格式的所有项目具有约束力;unsupported-route 表示停止并提供所列替代方案,不是允许自定义;custom 仅在客户选择时作为替代之一,且自定义视频仍须保留全部路由约束:人物以文字描述、无人物图像参考、单次拍摄、深焦、本地字体。 四、脚本规则。先保存情境 brief 再写对话;按用户要求的数量写,再把台词与动作映射到有序镜头。经过剪辑的参与者回答或无声动作/反应可以作为开场。cfg.question 对应采访者第一句实际提问,只说一次。口播双声道与 3–8 个镜头控制在 6–15 秒,语速不超过 2.5 词/秒,并为动作留时间。新配置描述 interaction.type、visible_setup、participant_reason 与可选道具;缺失 interaction 默认 mic-only。不得强行加入问候/同意发言、编造使用历史或宣称即时产品功效。 五、生成与质检。product-guess 可付费生成:single_gen.py --brand <slug> 为试运行(报价与完整提示词),加 --seed 与 --yes 为付费单次拍摄(12 秒、720p)。build_episode.py 将三个 take 拼成约 25–30 秒成片;check-cut.py 为发布门禁,检查镜头长度、真实剪辑点拼接、字幕时间与安全区、每镜头环境声底噪、响度与真峰值、每句台词可听、细节与黑场,并每次打印无法评估项(人脸、理解度、听感)。必须完整观看与收听,不得发布 FAIL 成片。 六、对话类现状。对话类目前只运行配置校验与提示词预览;single_gen.py --yes 在渲染试点验证前拒绝该模式。自然语音、音频与镜头表现尚未验证。对话各子类型拒绝产品/场景参考绑定及手机、屏幕或 UI 演示;试运行成功不等于已完成的样品、挑战或成片。

使用方式:在产品所属项目中运行;品牌资源路径相对项目文件夹或 $STREET_INTERVIEW_ROOT 解析;运行目录为 --run <dir>(默认 projects/street-interview/),working/ 存中间产物,output/ 存交付物。命令示例:python scripts/selftest.py(免费自检);python scripts/single_gen.py --brand <slug>(试运行);python scripts/single_gen.py --brand <slug> --seed <n> --yes(付费单次拍摄);python scripts/build_episode.py --episode <name>(免费:调色、重剪、字幕、尾卡);python scripts/check-cut.py --episode <render>.episode.json(免费发布门禁)。产品猜测品牌数据放在 brands/<slug>.json,可复制 brands/demo-tallgrass-oat.json。付费调用经 GooseWorks 代理,不使用本地密钥;轮询超时用 media_proxy.resume_fal(request_id) 恢复,切勿重新提交。供应商政策拒绝(真人肖像、内容政策)会使 --yes 退出码 3,应说明原因而不重试。

可选设置:H3 Max 生成需加 --model minimax/h3-max/reference-to-video --resolution 1080P。品牌配置有六个默认关闭的生成开关(handover_grammar、natural_grammar、real_grammar、level_camera、no_signage、can_sealed_grammar),可从 brands/fizzroot-ep3-a.json(易拉罐)或 brands/oleara-ep1-a2.json(瓶子)新建品牌。片段文件支持 extra_head_s 与 brand_layer.caption_centre_y。单次重剪可先本地删除空白段,再加品牌层与尾卡,需本地 ffmpeg/ffprobe、PIL、NumPy、字体与本地 Whisper base 模型;缺失转录或时间不兼容会中止收尾。

适用场景:街访广告的脚本上下文准备、提示词构建与校验、产品猜测类单次生成与成片质检、单次重剪与字幕对齐。

限制:资料明确产品猜测为一次付费生成(12 秒 720p),30 秒成片为三次付费拍摄,调色、重剪、字幕与门禁免费,价格由 GooseWorks 报价;对话类媒体价格未验证。Seedance 拒绝部分写实人脸;多 take 成片难以保证同一街角;各 take 环境声可能不同;提示词长度参照 BytePlus 建议不超过 1000 英文词,当前 Fal schema 未声明上限。未提供的功能、收费与效果不在本介绍内。