Python SDK

准备工作

1. 在安装和使用阿里云SDK前，确保您已经注册阿里云账号并生成访问密钥（AccessKey）。详情请参考创建AccessKey。

2. 安装Python SDK核心库。 使用依赖包工具安装（推荐）。

   执行以下命令，安装阿里云SDK核心库：

    pip install aliyun-python-sdk-core

   自行下载安装。

   您可以使用git clone或其它手段下载aliyun-openapi-python-sdk并自行添加解决方案。

3. 安装多媒体AI搜索Python SDK。

   使用依赖包工具安装（推荐）。

   执行以下命令，安装多媒体AI Python SDK：

    pip install aliyun-python-sdk-multimediaai

   自行下载安装。

   您可以使用git clone或其它手段下载aliyun-python-sdk-multimediaai并自行添加解决方案。

   完整代码示例

# -*- coding: utf8 -*-
from aliyunsdkcore.client import AcsClient
from aliyunsdkmultimediaai.request.v20190810 import CreateLabelTaskRequest
from aliyunsdkmultimediaai.request.v20190810 import CreateCoverTaskRequest
from aliyunsdkmultimediaai.request.v20190810 import CreateGifTaskRequest
from aliyunsdkmultimediaai.request.v20190810 import GetTaskStatusRequest
from aliyunsdkmultimediaai.request.v20190810 import GetTaskResultRequest
# 创建 AcsClient 实例
client = AcsClient("<your-access-key-id>", "<your-access-key-secret>", "<region>")
# 创建结构化任务
request = CreateLabelTaskRequest.CreateLabelTaskRequest()
request.set_VideoUrl("<yourVideoUrl>")
request.set_VideoName("<yourVideoName>")
request.set_ApplicationId("<yourApplicationId>")
# request.set_CallbackUrl("<yourCallbackUrl>")  # 回调通知Url，此参数为可选
# request.set_TemplateId("<yourTemplateId>")    # 自定义模板id，此参数为可选，不传会使用默认模板
response = client.do_action_with_exception(request)
print(response)
# 创建视频首图任务
request = CreateCoverTaskRequest.CreateCoverTaskRequest()
request.set_VideoUrl("<yourVideoUrl>")
request.set_VideoName("<yourVideoName>")
request.set_ApplicationId("<yourApplicationId>")
# request.set_CallbackUrl("<yourCallbackUrl>")  # 回调通知Url，此参数为可选
# request.set_TemplateId("<yourTemplateId>")    # 自定义模板id，此参数为可选，不传会使用默认模板
response = client.do_action_with_exception(request)
print(response)
# 创建视频GIF任务
request = CreateGifTaskRequest.CreateGifTaskRequest()
request.set_VideoUrl("<yourVideoUrl>")
request.set_VideoName("<yourVideoName>")
request.set_ApplicationId("<yourApplicationId>")
# request.set_CallbackUrl("<yourCallbackUrl>")  # 回调通知Url，此参数为可选
# request.set_TemplateId("<yourTemplateId>")    # 自定义模板id，此参数为可选，不传会使用默认模板
response = client.do_action_with_exception(request)
print(response)
# 获取任务处理状态
request = GetTaskStatusRequest.GetTaskStatusRequest()
request.set_TaskId(<yourTaskId>)
response = client.do_action_with_exception(request)
print(response)
# 获取任务处理结果
request = GetTaskResultRequest.GetTaskResultRequest()
request.set_TaskId(<yourTaskId>)
response = client.do_action_with_exception(request)
print(response)
# 创建人脸库
request = CreateFaceGroupRequest.GetCreateFaceGroupRequest()
request.set_FaceGroupName(<yourFaceGroupName>)
request.set_FaceDescription(<yourFaceDescription>)
response = client.do_action_with_exception(request)
print(response)
# 创建人脸库人物
request = CreateFacePersonRequest.CreateFacePersonRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
request.set_FacePersonName(<yourFacePersonName>)
response = client.do_action_with_exception(request)
print(response)
# 注册人脸
request = RegisterFaceImageRequest.RegisterFaceImageRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
request.set_FacePersonId(<yourFacePersonId>)
request.set_ImageUrl(<yourImageUrl>)
response = client.do_action_with_exception(request)
print(response)
# 删除人脸库
request = DeleteFaceGroupRequest.DeleteFaceGroupRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
response = client.do_action_with_exception(request)
print(response)
# 删除人脸库人物
request = DeleteFacePersonRequest.DeleteFacePersonRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
request.set_FacePersonId(<yourFacePersonId>)
response = client.do_action_with_exception(request)
print(response)
# 删除人脸库人物图片
request = DeleteFaceImageRequest.DeleteFaceImageRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
request.set_FacePersonId(<yourFacePersonId>)
request.set_FaceImageId(<yourFaceImageId>)
response = client.do_action_with_exception(request)
print(response)
# 获取人脸库列表
request = ListFaceGroupsRequest.ListFaceGroupsRequest()
request.set_PageNumber(<yourPageNumber>)
request.set_PageSize(<yourPageSize>)
response = client.do_action_with_exception(request)
print(response)
# 获取人脸库人物图片列表
request = ListFaceImagesRequest.ListFaceImagesRequest()
request.set_FaceGroupId(<yourFaceGroupId>)
request.set_FacePersonId(<yourFacePersonId>)
request.set_PageNumber(<yourPageNumber>)
request.set_PageSize(<yourPageSize>)
response = client.do_action_with_exception(request)
print(response)