用途：部署并消费 VDMS DataPrep 视频摄取栈（dataprep + VDMS 向量库 + MinIO），把视频转为嵌入写入 VDMS。API 基址为 http://localhost:6007/v1/dataprep。注意该服务只负责摄取，查询/检索嵌入属于另一组件。
主要能力：启动栈并检查健康；直接上传或从 MinIO 摄取 MP4 并生成嵌入；为视频时间段添加文本摘要嵌入；列出、下载、删除已摄取视频；诊断 413 上传、维度不匹配、MinIO 凭据错误。
使用方式：在仓库 microservices/visual-data-preparation-for-retrieval/vdms/ 下操作，或从 GitHub raw 获取 setup.sh 与 docker/compose.yaml。凭据不提交，需在 shell 中导出强值。启动示例：bash -c 'export MINIO_ROOT_USER="<user>" MINIO_ROOT_PASSWORD="<password>" EMBEDDING_MODEL_NAME="CLIP/clip-vit-b-32" REGISTRY_URL=intel TAG=latest && source ./setup.sh --nosetup && docker compose -f docker/compose.yaml up -d --no-build'。setup.sh 固定 INDEX_NAME=video-rag。等待健康：curl -sf http://localhost:6007/v1/dataprep/health，需 embedding_mode 非 sdk 或 sdk_client_status=preloaded；该端点不探测 MinIO/VDMS，需另查 compose ps、http://localhost:6010/minio/health/live 与 6020 端口。上传：curl -s -X POST 'http://localhost:6007/v1/dataprep/videos/upload?frame_interval=15' -F 'file=@/path/to/video.mp4;type=video/mp4'。上传响应只有状态/消息，需用 GET /videos 取 dp_video_<timestamp> 标识，再 POST /summary 附加摘要。管理：GET /videos、GET /telemetry?limit=5、GET /videos/download?video_id=…、DELETE /videos/{bucket_name}/{video_id}（不带 video_name 会删除整个视频目录，破坏性操作需先确认）。MinIO 控制台 http://localhost:6011。停止：docker compose -f docker/compose.yaml down。
限制：首次摄取需联网下载 YOLOX 检测器，否则对象检测被静默跳过；413 时源端点未实现大小检查，需从头部与日志定位拒绝方，大文件建议先入 MinIO 再用 POST /videos/minio；维度不匹配需覆盖 INDEX_NAME 或清空后重摄取；重新部署后 MinIO 认证错误需核对容器 MINIO_ROOT_* 与客户端凭据；启动时 MinIO 绑定挂载错误需在 source setup.sh --nosetup 后导出可写路径再手动调用 Compose。更多接口见 docs/user-guide/api-reference.md 与 openapi.yaml。