媒体文件 CRUD:媒体文件 / 文件夹的列表、详情、改元信息、批量删除(软删进回收站 / 硬删不进回收站)、批量移动、单文件裁剪、批量改"地图显示"开关。
下载与上传:客户端直传到 OSS 的 STS 凭证(详见 公共基础教程)+ 上传完成回调、秒传、外部导入、新文件指纹查重、涂鸦回调;批量打包 zip + 进度查询;单文件下载 URL(302 跳转 OSS)。
文件统计与查询:媒体文件按文件夹粒度计数 + 项目维度总数;媒体资源文件统一列表(图 + 文件夹,不含视频)。
标签管理:媒体文件标签的添加 / 删除 / 项目内已用标签列表。
飞行任务关联:按飞行任务架次 (flight_id) 查询其产出的媒体;批量按多个 flight_id 查询。
1.
指纹查重:检查新文件指纹存在状态 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files/tiny-fingerprints) — 上传前用小指纹批量查重;前端做差集决定上传哪些文件。
2.
秒传分支:快速上传媒体文件 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/fast-upload) — 对 OSS 已存在相同指纹的文件,跳过实际上传,直接登记记录到媒体库。
3.
直传分支:先调 获取媒体上传 STS 凭证 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/sts) 拿凭证,再用对象存储 SDK 直传。
4.
入库登记:媒体上传完成回调 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/upload-callback) — spec 定义的顶层字段:object_key、name、fingerprint、path、parent_id、sub_file_type、ext、metadata、automatic_rename、media_source、file_type、ai_alarm_objs。EXIF / GPS / 关联飞行任务 ID 等业务上下文通常以嵌套字段形式放在 ext / metadata 内,具体结构以接口 schema 为准。
5.
涂鸦标注图层入库:涂鸦回调 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files/{id}/graffiti-callback) — 客户端把对图片做的涂鸦标注图层(含若干涂鸦项)上传到 OSS 后调本接口登记。
6.
外部数据源导入:导入媒体文件 (POST /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files/import) — 从外部源(如 datahub 数据集 / AI 任务工作流节点)导入媒体到当前项目媒体库。
1.
主列表:获取媒体文件列表 (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files) — 支持按文件类型组合、地图显示、文件夹层级、关键字、设备 / 负载机型、时间范围、标签、任务类型等多维度过滤。
2.
资源列表(图 + 文件夹):获取媒体资源文件(图 + 文件夹) (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/resource_files) — 服务端强制 file_types=[image, dir],仅返回图片和文件夹,不返回视频;适用于做高级筛选(移动场景、复杂多过滤)。
3.
详情:获取媒体文件详情 (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files/{id}) — 含基础属性 / EXIF / GPS / 拍摄设备 / 标签 / 分享状态 / AI 视频处理状态 / 全景图切片状态等。
4.
文件夹粒度:获取媒体文件计数(按文件夹粒度) (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/count) — 用于文件夹层级的角标数字显示。
项目维度:获取媒体文件总数(项目全量) (GET /openapi/v2.0/media/api/v1/workspaces/{workspace_id}/file-count) — 复用 count 接口同 handler,按文件类型过滤。