人类与智能体齐欢庆：Mux Robots 正式 GA
内容提要
Mux Robots 正式 GA，API v1 稳定上线。文章指出代码不再是瓶颈，API 设计一致性对 AI 代理尤为重要。新增 analyze-structure 工作流，可一次生成标题、摘要、章节、场景和关键时刻；新增 generate-contextual-text，可基于视频生成社媒、博客等文案。v0 将继续支持六个月，并提供迁移指南。此外还介绍了 Playground、免费额度以及字幕、审核等多项改进。
延伸解读
API 一致性对 AI 代理为何更关键
文章指出，代理比人类更依赖 API 的一致性：看过三个端点后，代理能正确推断第四个的形状。一致的命名、字段和单位（如 v1 统一用秒）能减少“意外”，让集成一次成功，避免消耗大量 token 后仍需人工介入。这解释了 Mux Robots v1 为何强调与 Mux Video 的约定对齐，而非仅增加功能。
analyze-structure 如何减少重复分析
此前获取标题、章节、场景和关键时刻需分别运行多个工作流，每个都独立重读同一视频，上下文不共享。analyze-structure 一次作业返回全部结构化结果，时间戳对齐镜头边界，还可将标题和章节直接写回资产，省去额外 API 调用。它取代了独立的 find-scenes，迁移主要是改名并读取 scenes 输出。
generate-contextual-text 与直接粘贴转录的区别
该工作流从视频提取一份编辑简报，再基于同一简报生成社媒、博客等多渠道文案，确保不同产物故事一致。与把转录粘贴给 LLM 相比，转录仍是名称、主张和含义的权威来源，写作不能编造视频内容；且它是可持久化、通过 webhook 交付的 Robots 作业，而非聊天窗口。启用 use_shots 还能将镜头帧作为视觉证据。
v0 迁移窗口与 webhook 兼容策略
v1 无核心结构变化，但统一了时间单位、命名和轨道处理方式。v0 至少继续支持六个月，现有作业和执行契约不变。v1 作业发出新事件族 robots.v1.job.<workflow>.<status>，投递到现有 webhook 端点，因此可先让处理器同时接受新旧事件族，再安全迁移作业创建。官方提供迁移指南和给编码代理的现成提示。
Q&A
Mux Robots 正式 GA 后，API v1 有哪些主要变化？
API v1 在 /robots/v1 上线，没有核心结构变化，但带来了更好的一致性和兼容性：媒体时间戳统一为秒，命名和字段约定与 Mux Video 对齐，所有生成轨道的 workflow 通过 replace_existing_tracks 统一处理现有轨道，并移除了预览期的废弃参数。v0 将继续支持六个月，现有作业和指令的执行与 webhook 契约不变。
analyze-structure 工作流有什么作用？它和之前的 find-scenes 是什么关系？
analyze-structure 一次运行即可返回视频的标题、摘要、标签、章节、场景和关键时刻，基于共享上下文而非多次独立分析。它取代了独立的 find-scenes 工作流（find-scenes 在 v1 中弃用，但 v0 上继续支持六个月）。迁移时只需创建 analyze-structure 作业并读取结果中的 scenes 即可。
generate-contextual-text 和直接使用 LLM 处理转录文本有什么区别？
主要区别在于 grounding（接地性）：转录文本对名称、声明和含义保持权威，因此生成内容不会编造视频中没有的信息。一个编辑简报驱动所有产出，确保不同渠道（如 X 帖子和博客文章）讲述一致的故事。此外，它是一个持久的 Robots 作业，通过 webhook 交付，易于深度集成，而不是聊天窗口。
Robots Playground 能做什么？对开发者有什么帮助？
Robots Playground 在 Mux 仪表板中，允许你选择资产并运行任何工作流，查看完整渲染的输出（如章节列表、可播放的关键时刻片段、审核分数及证据）。每个工作流还会生成可复制粘贴的提示词，供编码代理使用，涵盖 API 调用和结果处理方式，方便快速构建集成。
Mux Robots 在免费计划中提供多少额度？
Robots 包含在所有 Mux 计划中，包括免费计划，每月提供 100,000 个包含单元。
自预览以来，Mux Robots 有哪些值得关注的改进？
改进包括：summarize 可写入标题、generate-chapters 可发布章节轨道、find-best-thumbnails 可设置缩略图；文本工作流支持语气、受众和品牌术语引导，并可针对时间范围运行；新增 replace_existing_tracks 选项控制轨道处理；generate-premium-captions 转为生产就绪并支持关键术语列表；moderate 可删除超过阈值的播放 ID；关键时刻支持可引用片段和镜头感知选择；translate-captions 支持不翻译术语列表；Directives 支持运行级 webhook 和更多工作流。
