AutoMagicCalib 视频标定
通过 REST API 将本地多摄像头 MP4 视频转换为 AutoMagicCalib 标定结果。
技能明确说明视频会上传到AMC后端,并要求使用可信网络;校准前有计划确认,上传、配置和校准范围按项目限定。扣分原因是默认使用HTTP、未定义认证或凭据处理、没有回滚/删除机制,且配置文件会原样提交。
文档与脚本覆盖创建、上传、校验、轮询和错误日志路径,成功流程基本连贯。扣分原因是脚本缺少服务可达性预检,部分GET请求未调用raise_for_status,配置解析异常被静默忽略,VGGT超时缺少明确失败处理,且脚本与文档在确认和检测器询问行为上不完全一致。
触发语句、MP4输入、命名约束、可选文件、RTSP和样例数据的非适用边界均较清楚。扣分原因是未提供中文交互支持或主流中国大陆环境验证,且对AMC部署环境和文件内容的边界说明有限。
文档结构清晰,包含前置条件、步骤、输出、故障排查、相关技能、版本、所有者和许可证信息;仓库还提供评估报告和更新说明。扣分原因是缺少独立Examples章节,变更日志和该技能的具体维护责任/更新路径不够明确,skill-card的许可证表述与题设NOASSERTION元数据存在不一致。
技能提供可直接运行的Python脚本和完整REST工作流,覆盖手动对齐、GT、焦距和VGGT等主要分支,能产出项目ID和结果位置。扣分原因是静态审查不能验证实际结果,脚本与声明的预检/交互行为有缺口,内部评估中的正确性和有效性结果也仅为有限证据,因此只能给予中低分。
源文件包含脚本、评估任务、期望行为和内部基准结果,支持有限审计。扣分原因是没有可见的CI或提交测试套件,基准为内部单次评估且无法由静态材料独立复现,第三方交叉佐证不足。
- 默认BASE_URL使用HTTP,视频和配置可能包含敏感内容;部署时应使用受控网络、认证和必要的TLS保护。
- 脚本不会在校准前执行文档所述的/v1/ready预检,且非交互模式会直接开始校准;应先确认服务可达并核对计划。
- 脚本对部分网络响应和VGGT超时处理不完整,长任务可能留下不明确状态或已创建的项目。
- 未提供中文交互或中国大陆网络可达性证据,使用前需验证本地AMC服务和依赖环境。
这个 Skill 能做什么,适合哪些场景?
该技能面向拥有本地预录制 MP4 文件、需要运行 AutoMagicCalib 标定的用户。它创建项目、按字母顺序上传视频,并处理标定设置、对齐数据、布局图及可选的真值和焦距文件。技能通过 API 验证项目、启动标定并轮询运行状态,完成后获取日志和评估结果。它要求 AMC 微服务和 UI 已运行,不适用于 RTSP 或其他实时流。
读取本地 cam_*.mp4 视频及可选配置、对齐、布局、GT.zip 和焦距文件;调用 AutoMagicCalib REST API 创建项目、上传文件、验证项目、启动标定并查询状态;在需要时引导用户通过 UI 完成缺失的设置或手动对齐;标定完成后返回项目状态、日志、评估统计和项目 ID,VGGT 就绪且用户同意时还可运行 VGGT refinement。
- 计算机视觉工程师拥有 cam_00.mp4、cam_01.mp4 等同步视频,需要标定新的多摄像头数据集。
- 团队已部署 AutoMagicCalib 微服务和 UI,希望通过 REST API 批量提交本地视频。
- 评测人员拥有 GT.zip,需要在标定后获取平均 L2 距离和重投影误差。
- 用户需要在遮挡较多的场景中选择 transformer 检测器,或在常规场景中使用默认的 resnet。
- 下游多视角 3D 跟踪流程需要已完成标定的 project_id,以便后续获取 MV3DT 格式结果。
这个 Skill 有哪些优点和局限?
- 提供从项目创建到结果获取的完整 REST API 工作流。
- 支持自动发现配置、对齐和布局文件,并保留 UI fallback。
- 支持 resnet 与 transformer 检测器、GT 评估、焦距覆盖和可选 VGGT refinement。
- 上传顺序和项目状态等关键决策有明确说明。
- 必须已有运行中的 AutoMagicCalib 微服务和 UI。
- 视频会上传到 AutoMagicCalib 后端,只适用于受信任的平台或网络。
- 仅支持预录制 MP4,不处理 RTSP 或实时流。
- 标定通常需要 10 至 60 分钟,视频过大时可能需要调整上传超时。
- 源材料没有提供该技能独立运行结果或平台覆盖范围的实测数据。
如何安装这个 Skill?
使用 NVIDIA 技能集合的 CLI 安装:
npx skills add nvidia/skills --skill amc-run-video-calibration --yes
也可指定目标客户端,例如:
npx skills add nvidia/skills --skill amc-run-video-calibration --agent codex
源材料未说明其他手动安装步骤;技能集合 README 建议无需克隆仓库或手动复制目录。
如何使用这个 Skill?
准备已运行的 AMC 微服务和 UI、微服务 URL、项目名称,以及按 cam_00.mp4、cam_01.mp4 等命名且时间同步的本地视频。向代理发送“calibrate my videos”或“run AMC on these videos”,并提供视频目录、微服务 URL 和项目名称;按提示补充或确认配置、对齐、布局、检测器及可选真值和焦距。代理会在启动 /calibrate 前请求确认,随后轮询项目直至 COMPLETED、ERROR 或需要处理的状态。RTSP/live stream 请求应使用另一个技能。
这个 Skill 与同类方案有什么区别?
它明确区别于 amc-run-rtsp-calibration:本技能处理本地预录制 MP4,实时 RTSP 流应交给后者。它也支持在本地文件缺失时通过 AutoMagicCalib UI 完成相关步骤。