开发者指南
更新时间:2022-08-25
多模态媒资检索
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">
发起多模态媒资检索
指定媒资路径发起多模态媒资检索。
创建视频库
本接口用于创建视频库。
代码示例:
video_lib = "test_video_lib"
params = {"description": "test create lib"}
response = mms_client.create_video_lib(video_lib, params)
视频入库
根据BOS bucket和BOS key直接发起视频入库。需要说明,使用本方法需要将object配置公共GetObject权限,参考设置BOS bucket权限。简述为:在BOS 的控制台中 Bucket 设置-权限设置-自定义权限中添加 MMS 服务账号: 4523a498c3de4c9ab330f376d1bc2c2d。
代码示例:
video_lib = "test_video_lib"
video_url = "https://测试视频.mp4"
response = mms_client.insert_video(video_lib, video_url)
查询视频入库结果
本接口用于查询视频入库结果。
代码示例:
video_lib_id = "test_video_lib_id"
video_id = "video_id"
response = mms_client.get_insert_video_task_result_by_id(video_lib_id, video_id)
创建图片库
本接口用于创建图片库。
代码示例:
image_lib = "test_image_lib"
params = {"description": "test create lib"}
response = mms_client.create_image_lib(image_lib, params)
图片入库
本接口用于向图片库中插入图片特征。
代码示例:
image_lib = "test_image_lib"
image_url = "https://测试图片.jpg"
response = mms_client.insert_image(image_lib, image_url)
视频检索视频
本接口使用视频来检索库中存在的相似视频。
代码示例:
video_lib = "test_video_lib"
video_url = "https://测试视频.mp4"
response = mms_client.create_search_video_by_video_task(video_lib, video_url)
根据任务ID查询视频检索视频结果
本接口用于查询视频检索视频任务的结果。
代码示例:
video_lib = "test_video_lib"
task_id = "task_id"
response = mms_client.get_search_video_by_video_task_result_by_id(video_lib, task_id)
图片检索图片
本接口使用图片来检索库中存在的相似图片。
代码示例:
image_lib = "test_image_lib"
image_url = "https://测试图片.jpg"
response = mms_client.search_image_by_image(image_lib, image_url)
图片检索视频
本接口使用图片来检索库中存在的包含相似图片的视频。
代码示例:
video_lib = "test_video_lib"
image_url = "https://测试图片.jpg"
response = mms_client.search_video_by_image(image_lib, image_url)
根据视频ID删除视频库中的视频特征
本接口用于删除视频库中某个视频的特征。
代码示例:
video_lib_id = "test_video_lib_id"
video_id = "video_id"
response = mms_client.delete_video_by_id(video_lib_id, video_id)
删除图片库中的图片特征
本接口用于删除图片库中某张图片的特征。
代码示例:
image_lib_id = "test_image_lib_id"
image_id = "image_id"
response = mms_client.delete_image_by_id(image_lib_id, image_id)
查询视频库中视频列表
本接口用于查询视频库中视频列表。
代码示例:
video_lib_id = "test_video_lib_id"
response = mms_client.list_media({"type": "VIDEO", "id": video_lib_id})
查询图片库中图片列表
本接口用于查询图片库中图片列表。
代码示例:
image_lib_id = "test_image_lib_id"
response = mms_client.list_media({"type": "IMAGE", "id": image_lib_id})
删除视频库
本接口用于删除视频库。
代码示例:
video_lib_id = "test_video_lib_id"
response = mms_client.delete_video_lib(video_lib_id)
删除图片库
本接口用于删除图片库。
代码示例:
image_lib_id = "test_image_lib_id"
response = mms_client.delete_image_lib(image_lib_id)
说明:
各参数含义参考MMS API。