用途：把视频交给 Sonilo 后返回声音创作简报，作为后续生成调用的输入。默认 mode="both" 会同时给出两份简报：音乐方向简报包含按时间段划分的规划（segments）与一个或多个可直接使用的生成提示词（variations）；音效设计简报包含镜头级的 sfx_segments 与整段 sfx_prompt。mode="music" 或 "sfx" 只返回其中一份，价格相同。该技能不生成音频、视频或文件，输出仅为文本。
主要能力：segments 为整秒边界与逐段方向，label 为音乐段落标签或 "none"；variations[i].prompt 是要原样使用的载荷，可传给 video_to_music、video_to_sfx、video_to_sound 等；sfx_prompt 为整段音效设计提示词，每次调用只生成一份，不随 variants_num 增加。mode 会回显所请求的值。
使用方式：优先使用会话中可见的 Sonilo MCP 工具 analyze_video；本地服务器支持 video_path，托管（OAuth）服务器仅支持 video_url。也可用 Python（pip install sonilo）、JavaScript/TypeScript（npm install sonilo）或 CLI（npm install -g sonilo-cli 或 pip install sonilo-cli）。CLI 示例：sonilo video-analysis --video trailer.mp4 --prompt "focus on the chase" --variants 2；仅音效简报：sonilo video-analysis --video trailer.mp4 --mode sfx。MCP 与 CLI 请择一使用，勿混用。鉴权见 setup-api-key 技能：sonilo login（无需 key）或 SONILO_API_KEY。
参数：video_path 与 video_url 二选一；prompt 为可选分析引导（不超过 2000 字符，不是生成提示词）；variants_num 默认 1，范围 1–5，按简报计费；mode 为 both/music/sfx。视频上限 480 秒（8 分钟），并受账号上传大小限制。
适用场景：用户不知道视频该配什么声音；首次生成效果不理想（问题通常出在简报而非模型）；视频有明显分段需要分别配乐。若用户已明确需求（如指定情绪与节点），直接走 video-to-music，不必先分析。
限制与费用：这是付费调用，即使不生成任何内容；计费有 10 秒下限，variants_num 按简报计费，3 个变体即 3 倍费用，调用前应先确认。analyze_video 为异步：超时后错误信息会带 task_id，应通过 get_sfx_task(task_id)（托管服务器为 get_generation_task）取回，不要重跑以免二次计费。提示词不得涉及具体艺人、乐队或受版权保护的歌词。常见错误包括 401、402、413、422（超长、无视频流、variants_num 越界、mode 无效）、429；分析失败返回 error.code ANALYSIS_FAILED 并退款；503 表示服务端暂时禁用视频分析。