开发者指南
更新时间：2025-08-03
多模态媒资检索
MMS 支持对BOS媒资、VOD媒资、URL媒资检索。对于不同来源的视频，需要按照如下规则拼接媒资路径source:
- 对于 BOS 视频，
source=bos://{bucket}/{object} - 对于 VOD 媒资原视频，
source=vod://{mediaId} - 对于 VOD 媒资转码后视频，
source="vod://<vod-media-id>-<preset>" - 对于 URL 视频，
source="<http(s)-url">
发起多模态媒资检索
指定媒资路径发起多模态媒资检索。
创建视频库
本接口用于创建视频库。
代码示例：
Python
1video_lib = "test_video_lib"
2params = {"description": "test create lib"}
3response = mms_client.create_video_lib(video_lib, params)视频入库
根据BOS bucket和BOS key直接发起视频入库。需要说明，使用本方法需要将object配置公共GetObject权限，参考设置BOS bucket权限。简述为：在BOS 的控制台中 Bucket 设置-权限设置-自定义权限中添加 MMS 服务账号： 4523a498c3de4c9ab330f376d1bc2c2d。
代码示例：
Python
1video_lib = "test_video_lib"
2video_url = "http://测试视频.mp4"
3response = mms_client.insert_video(video_lib, video_url)查询视频入库结果
本接口用于查询视频入库结果。
代码示例：
Python
1video_lib_id = "test_video_lib_id"
2video_id = "video_id"
3response = mms_client.get_insert_video_task_result_by_id(video_lib_id, video_id)创建图片库
本接口用于创建图片库。
代码示例：
Python
1image_lib = "test_image_lib"
2params = {"description": "test create lib"}
3response = mms_client.create_image_lib(image_lib, params)图片入库
本接口用于向图片库中插入图片特征。
代码示例：
Python
1image_lib = "test_image_lib"
2image_url = "http://测试图片.jpg"
3response = mms_client.insert_image(image_lib, image_url)视频检索视频
本接口使用视频来检索库中存在的相似视频。
代码示例：
Python
1video_lib = "test_video_lib"
2video_url = "http://测试视频.mp4"
3response = mms_client.create_search_video_by_video_task(video_lib, video_url)根据任务ID查询视频检索视频结果
本接口用于查询视频检索视频任务的结果。
代码示例：
Python
1video_lib = "test_video_lib"
2task_id = "task_id"
3response = mms_client.get_search_video_by_video_task_result_by_id(video_lib, task_id)图片检索图片
本接口使用图片来检索库中存在的相似图片。
代码示例：
Python
1image_lib = "test_image_lib"
2image_url = "http://测试图片.jpg"
3response = mms_client.search_image_by_image(image_lib, image_url)图片检索视频
本接口使用图片来检索库中存在的包含相似图片的视频。
代码示例：
Python
1video_lib = "test_video_lib"
2image_url = "http://测试图片.jpg"
3response = mms_client.search_video_by_image(image_lib, image_url)根据视频ID删除视频库中的视频特征
本接口用于删除视频库中某个视频的特征。
代码示例：
Python
1video_lib_id = "test_video_lib_id"
2video_id = "video_id"
3response = mms_client.delete_video_by_id(video_lib_id, video_id)删除图片库中的图片特征
本接口用于删除图片库中某张图片的特征。
代码示例：
Python
1image_lib_id = "test_image_lib_id"
2image_id = "image_id"
3response = mms_client.delete_image_by_id(image_lib_id, image_id)查询视频库中视频列表
本接口用于查询视频库中视频列表。
代码示例：
Python
1video_lib_id = "test_video_lib_id"
2response = mms_client.list_media({"type": "VIDEO", "id": video_lib_id})查询图片库中图片列表
本接口用于查询图片库中图片列表。
代码示例：
Python
1image_lib_id = "test_image_lib_id"
2response = mms_client.list_media({"type": "IMAGE", "id": image_lib_id})删除视频库
本接口用于删除视频库。
代码示例：
Python
1video_lib_id = "test_video_lib_id"
2response = mms_client.delete_video_lib(video_lib_id)删除图片库
本接口用于删除图片库。
代码示例：
Python
1image_lib_id = "test_image_lib_id"
2response = mms_client.delete_image_lib(image_lib_id)说明：
各参数含义参考MMS API。