用途:在三种输入源之一上端到端运行 AutoMagicCalib,并通过微服务 REST API 驱动标定;输入解析因源而异,从 verify_project 起流程一致。按路由表选择模式:deploy(部署/启动 AMC 微服务)、videos(本地 cam_*.mp4)、rtsp(实时 RTSP 流)、sample-dataset(测试内置样例/验证安装)。歧义时通过 AskUserQuestion 询问。
主要能力:共享标定尾部为 验证→标定→轮询→结果:POST /v1/verify_project/<project_id> 确认 project_state 为 READY;POST /v1/calibrate/<project_id> 以 JSON {"detector_type": "resnet"}(或 transformer)启动,标定前需确认 plan;GET /v1/get_project_info/<project_id> 每 10 秒轮询,状态 RUNNING/COMPLETED/ERROR;结果查询 GET /v1/result/<id>/evaluation_statistics(仅上传 GT 时有)、/overlay_image、GET /v1/amc/calibrate/<id>/log。可选 VGGT 精化:POST /v1/vggt/calibrate/<id>,轮询 vggt_state 并取 /v1/vggt_results/<id>/evaluation_statistics。可选 settings 文件 POST /v1/config/<project_id>(原样提交),并从文件解析 detector。
使用方式:前置为 AMC 微服务与 UI 运行,服务可达 http://<HOST_IP>:${VSS_AUTO_CALIBRATION_PORT:-8010}/v1/ready 返回 {"code":0,...},projects 目录可写,Python 3 与 requests。命令与 API 保持原文。
限制:需匹配的 VSS profile/微服务已部署且可达;NGC 托管模型/NIM 可能受速率、GPU 显存与许可限制;并发、显存与存储取决于主机与 compose;典型耗时 10–60 分钟(自有视频)、10–30 分钟(样例)。常见错误包括连接拒绝(未运行)、401/403(NGC_CLI_API_KEY 缺失/过期)、OOM、verify 未 READY、命名不连续等,按表排查。更多细节见各 references 文件。