用途:部署并调用 Intel Multimodal DataPrep,为多模态媒体生成嵌入与元数据以供检索。它不提供向量查询/搜索端点。API 基址为 http://localhost:6007/v1/dataprep。
主要能力:支持视频与图像上传、内联 base64 或远程 HTTP(S) 图像摄取、已在存储中的媒体处理,以及批量上传/处理/摄取和目录摄取;可启用目标检测、设置帧间隔与标签;支持添加文本摘要、列出媒体、下载(含 HTTP Range)、删除单项或整个 bucket,并读取摄取遥测。
部署方式:向量后端可选 VDMS(默认)或 Milvus,媒体存储可选 MinIO(默认)或本地文件系统,对应 docker/compose.yaml、docker/compose-milvus.yaml、docker/compose.storage-local.yaml。可用 MM_DATAPREP_VECTORDB_BACKEND 与 MM_DATAPREP_STORAGE_BACKEND 配置。无仓库检出时可用 curl 获取 setup.sh 与 compose 文件。启动前需设置 MINIO_ROOT_USER、MINIO_ROOT_PASSWORD、EMBEDDING_MODEL_NAME、REGISTRY_URL、TAG 等环境变量,然后 source ./setup.sh --nosetup 并执行 docker compose -f docker/compose.yaml up -d --no-build。setup.sh 必须 source,无参数时只导出默认值,不启动容器。
验证与使用:轮询 /health 等待 embedding_client_status 为 preloaded,并单独检查依赖(如 MinIO 健康端点、VDMS 6020 或 Milvus 19530)。上传示例:curl -fsS -X POST 'http://localhost:6007/v1/dataprep/media/upload?frame_interval=15&enable_object_detection=true&tags=camera-1' -F 'file=@/path/to/video.mp4;type=video/mp4'。摘要接口为 POST /summary,需模型支持文本嵌入。
限制与注意:删除是破坏性操作,需明确确认;无单文件 video_name 删除选项。目录摄取路径须位于 MM_DATAPREP_INGEST_DATA_ROOT 之下。重复上传可能因内容哈希去重返回 409;大文件可能返回 413。维度不匹配应使用与所选模型兼容的新集合。具体请求模式与批处理上限请查阅 API 参考文档。