本文介绍了如何使用阿里云视觉智能开放平台相关服务的Python SDK,具体包括SDK的获取、安装方法以及SDK代码示例。
阿里云视觉智能开放平台各类目视觉AI能力SDK接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
本文介绍旧版SDK Python,最低环境要求Python 2.7,如果您的Python是3.x及以上版本,推荐使用新版Python。
准备工作
在安装和使用阿里云SDK前,确保您已经注册阿里云账号并生成访问密钥(AccessKey)。详情请参见创建AccessKey。
安装Python SDK核心库。
说明该SDK包为阿里云Java核心库,无论使用哪个产品的SDK,都必须先安装该核心库。
使用依赖包工具安装(推荐)。
执行如下命令,安装阿里云SDK核心库。
pip install aliyun-python-sdk-core
自行下载安装:使用
git clone
或其它方式从GitHub下载aliyun-python-sdk-core并自行添加解决方案。
安装视觉智能API相关服务Python SDK。
使用依赖包工具安装(推荐)。
执行以下命令,安装需要的SDK包。
说明仅安装所需要的SDK包即可。
人脸人体:
pip install aliyun-python-sdk-facebody
文字识别:
pip install aliyun-python-sdk-ocr
商品理解:
pip install aliyun-python-sdk-goodstech
内容审核:
pip install aliyun-python-sdk-imageaudit
图像识别:
pip install aliyun-python-sdk-imagerecog
图像生产:
pip install aliyun-python-sdk-imageenhan
分割抠图:
pip install aliyun-python-sdk-imageseg
目标检测:
pip install aliyun-python-sdk-objectdet
图像分析处理:
pip install aliyun-python-sdk-imageprocess
视觉搜索:
pip install aliyun-python-sdk-imgsearch
视频理解:
pip install aliyun-python-sdk-videorecog
视频生产:
pip install aliyun-python-sdk-videoenhan
视频分割:
pip install aliyun-python-sdk-videoseg
自行下载安装:使用
git clone
或其它方式下载SDK包并自行添加解决方案。详细下载地址如下所示。AI类目
Github链接
pypi链接
人脸人体
文字识别
商品理解
内容审核
图像识别
图像生产
分割抠图
目标检测
视觉搜索
图像分析处理
视频生产
视频理解
视频分割
配置环境变量
配置环境变量ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。
阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维,具体操作,请参见创建RAM用户。
请不要将AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。
Linux和macOS系统配置方法
在IntelliJ IDEA中打开终端Terminal。
执行以下命令,配置环境变量。
<access_key_id>
需替换为您RAM用户的AccessKey ID,<access_key_secret>
替换为您RAM用户的AccessKey Secret。如果后续需要进行更多权限相关的配置,具体操作请参见使用RAM Policy控制访问权限。export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id> export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
Windows系统配置方法
新建环境变量文件,添加环境变量
ALIBABA_CLOUD_ACCESS_KEY_ID
和ALIBABA_CLOUD_ACCESS_KEY_SECRET
,并写入已准备好的AccessKey ID和AccessKey Secret。然后重启Windows系统。本操作以Windows 10为例进行说明。打开文件资源管理器,在此电脑上右键单击属性。
在右侧导航栏,单击高级系统配置。
在系统属性对话框的高级页签下,单击环境变量。
在环境变量对话框中,单击新建(W)。
在弹出的新建系统变量对话框中,添加环境变量
ALIBABA_CLOUD_ACCESS_KEY_ID
和ALIBABA_CLOUD_ACCESS_KEY_SECRET
,并写入已准备好的AccessKey ID和AccessKey Secret。重启Windows系统,使配置生效。
代码示例
本文以RecognizeBankCard为例,该方式目前只支持同地域下OSS文件,其他场景请使用新版Python。
#!/usr/bin/env python
#coding=utf-8
import os
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdkcore.auth.credentials import AccessKeyCredential
from aliyunsdkcore.auth.credentials import StsTokenCredential
from aliyunsdkocr.request.v20191230.RecognizeBankCardRequest import RecognizeBankCardRequest
# 创建AccessKey ID和AccessKey Secret,请参考https://help.aliyun.com/document_detail/175144.html。
# 如果您用的是RAM用户的AccessKey,还需要为RAM用户授予权限AliyunVIAPIFullAccess,请参考https://help.aliyun.com/document_detail/145025.html。
# 从环境变量读取配置的AccessKey ID和AccessKey Secret。运行代码示例前必须先配置环境变量。
credentials = AccessKeyCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'])
# use STS Token
# credentials = StsTokenCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'], os.environ['ALIBABA_CLOUD_SECURITY_TOKEN'])
client = AcsClient(region_id='cn-shanghai', credential=credentials)
request = RecognizeBankCardRequest()
request.set_accept_format('json')
response = client.do_action_with_exception(request)
# python2: print(response)
print(str(response, encoding='utf-8'))