youtube-popup-graphic

用途：该技能用于制作 YouTube 视频中的单张弹出式 UI 动效图形（popup motion graphic），风格严格对齐用户提供的界面/风格参考图（如仪表盘截图、玻璃卡片、深色模式 UI 等）。最终输出为一段卡片从画面中干净弹出、并在结束构图停留的 MP4 视频。

主要能力：

• 以用户上传的 UI/风格参考图作为视觉主题锚点，生成匹配其配色、材质、阴影、字体和强调色的弹出卡片。
• 通过 Higgsfield MCP 的 generate_video 调用 seedance_2_0 模型生成视频，不依赖本地图像或视频工具。
• 默认参数：16:9 比例、8 秒时长、1080p 分辨率、genre 为 auto，参考图角色为 image（风格锚点）。
• 默认音频方向为仅音效（无背景音乐），可在提示词中明确要求。
• 支持多条目请求：为每个条目并行生成独立视频，最后汇总所有 URL，供后期拼接。

使用方式：

1. 收集条目名称（卡片上要显示的名称）与风格参考图的本地路径；参考图为必填项，缺失时需向用户索取。
2. 通过 ToolSearch 一次性加载 Higgsfield MCP 的 media_upload、media_confirm、generate_video、job_display、balance 工具。
3. 调用 balance 检查额度；额度不足则停止并告知用户差额。
4. 通过 media_upload 上传参考图，按返回的 upload_url 用 curl PUT 上传字节，再调用 media_confirm 确认，取得 media_id 作为 reference_media_id。
5. 调用 generate_video，传入 model 为 seedance_2_0、aspect_ratio 为 16:9、duration 为 8、resolution 为 1080p、genre 为 auto、count 为 1，medias 中传入参考 media_id 且 role 为 image，并使用简短的提示词描述单个卡片弹出动画、卡片内图标与文字、以及仅音效的音频方向。
6. 轮询任务（seedance 通常需 60–180 秒），使用后台 until 循环每 60–90 秒检查一次 job_display，避免忙轮询；完成后从 results.rawUrl 取得 MP4 地址。
7. 若服务端返回 preset_recommendation，则带 declined_preset_id 重试以强制执行字面生成。
8. 交付时给出 MP4 URL、参考图路径与所用提示词原文，并附任务 ID、时长、比例、分辨率与模型信息；多条目则列出全部条目与 URL。

适用场景：

• 为 YouTube 视频制作单个功能、技能或产品名称的弹出式 UI 卡片动画。
• 需要让动效风格与某张参考 UI 图保持一致的品牌/频道主题场景。
• 竖屏 Shorts（将比例改为 9:16）或方形（1:1）场景。

限制与约束：

• 必须使用 Higgsfield MCP，禁止使用 ffmpeg、ImageMagick、Pillow、yt-dlp 等本地图像/视频工具。
• 风格参考图必须提供，不能凭猜测继续。
• 参考图必须直接以 role 为 image 上传，不作为 start_image 或 end_image，也不经过中间图像生成步骤。
• 提示词应保持简短（约 6–10 行），让参考图承担美学锚定。
• 单次生成只放一个条目；多条目需并行多次生成。一次画面中出现多个文字标签时，视频模型易出现文字错乱，官方明确不建议。
• 默认仅音效；如不显式指定，seedance 可能自动加入音乐。
• 本地文件路径不能直接传给 generate_video，必须先上传确认。
• 未提供具体收费、价格或平台兼容性细节。