用途:对用户提供的本地预录制多相机 MP4 数据集(cam_00.mp4、cam_01.mp4……,时间同步、约 1920×1080)通过 AutoMagicCalib REST API 执行标定。实时 RTSP 流不适用,应改用 amc-run-rtsp-calibration 技能。
主要能力:引导完成项目创建、按字母序上传视频、本地文件自动解析、必要时回退到 UI、项目校验、启动标定、轮询、评估,以及可选的 VGGT 精化。无需 CLI 脚本或 Docker 绑定挂载,只需运行中的微服务与视频文件。
使用方式:前置条件为 AMC 微服务与 UI 已运行、已知微服务 URL 与 UI URL、Python 3 及 requests。必填输入为 VIDEO_DIR、BASE_URL、PROJECT_NAME;可选输入包括 CONFIG_FILE、ALIGNMENT_JSON、LAYOUT_PNG、GT_ZIP、FOCAL_LENGTHS、DETECTOR_TYPE,以及 CONFIRM_CALIBRATION、RUN_VGGT、PROJECTS_DIR、CALIBRATION_TIMEOUT_SECONDS、VGGT_TIMEOUT_SECONDS、ALLOW_INSECURE_HTTP。核心脚本为 run_video_calibration.py,按 create_project、upload_video_files、config/upload_alignment/upload_layout/upload_gt_file/upload_focal_length、verify_project、calibrate、轮询 get_project_info、result 评估的顺序执行。标定前需用户确认,非交互运行须设 CONFIRM_CALIBRATION=true;VGGT 需 RUN_VGGT=true 且 vggt_state 为 READY。
适用场景:仓库、仓储等固定多相机场景的离线标定与评估。
限制:仅支持本地预录制 cam_*.mp4,视频命名须连续且从 00 开始;实时 RTSP 与内置样例数据集不在范围内;非交互运行无法依赖 UI 回退;上传视频会传输到 AMC 后端,仅在可信网络使用;标定通常 10–60 分钟,默认超时 90 分钟;输出路径依赖正确的 PROJECTS_DIR。成功标准为 project_state 为 COMPLETED,且上传 GT 时 Average L2 distance(m) < 1.5、Average reprojection error 0(px) < 5。