Embed Size (px)
Citation preview
人工智能服务
用户指南
文档版本 06
发布日期 2017-11-23
华为技术有限公司
版权所有 © 华为技术有限公司 2017。 保留一切权利。
非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传
播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或
特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或默示的声
明或保证。
由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文
档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
华为技术有限公司
地址： 深圳市龙岗区坂田华为总部办公楼 邮编：518129
网址： http://www.huawei.com
客户服务邮箱： [email protected]
客户服务电话： 4008302118
文档版本 06 (2017-11-23) 华为专有和保密信息
版权所有 © 华为技术有限公司
i
目 录
1 简介................................................................................................................................................... 11.1 人工智能服务................................................................................................................................................................ 11.2 应用场景........................................................................................................................................................................ 41.3 与其他云服务的关系.................................................................................................................................................... 5
2 如何使用........................................................................................................................................... 7
3 约束限制........................................................................................................................................... 8
4 业务操作......................................................................................................................................... 114.1 申请服务...................................................................................................................................................................... 114.2 调用 API....................................................................................................................................................................... 114.2.1 构造请求方法........................................................................................................................................................... 114.2.2 发起请求................................................................................................................................................................... 144.2.3 解析响应消息........................................................................................................................................................... 144.2.4 状态码....................................................................................................................................................................... 154.3 查看服务使用信息...................................................................................................................................................... 18
5 常见问题......................................................................................................................................... 195.1 有哪些途径可以使用 AIS 的 API？.......................................................................................................................... 195.2 调用 AIS 的 API 失败时怎么处理？......................................................................................................................... 195.3 为什么实际调用次数与界面记录次数不一致？...................................................................................................... 195.4 为什么有时单据识别的结果会不准确？.................................................................................................................. 205.5 是否可以进一步提升图像去雾和低光照处理效果？.............................................................................................. 205.6 为什么有时报关遵从检测的结果会不准确？.......................................................................................................... 205.7 为什么智能装车效果较差？...................................................................................................................................... 20
A 修订记录........................................................................................................................................ 22
人工智能服务用户指南 目 录
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
ii
1 简介
1.1 人工智能服务
人工智能服务（Artificial Intelligence Service，以下简称AIS）集合了多种智能服务，使得应用这些服务的系统能看、能听、能说，具备分析和理解图片、视频、语音、文本等技能。
AIS以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取推理结果，帮助用户自动采集关键数据，打造智能化业务系统，提升业务效率。
目前，AIS已开放文字识别、智能物流、模糊图像高清重建、内容检测和图像识别等5类服务。
文字识别服务
文字识别是指对图像文件的打印字符进行检测识别，将图像中的文字转换成文本格式。当前，文字识别服务提供了单据识别和增值税发票等2个子服务。
l 单据识别：可识别出英文海关单据图片上的文字内容和数字，智能提取为可编辑的文本。单据识别采用了自动定位分割算法、分布式计算框架、集成深度学习进行判断纠错，经过大规模图像文字训练，达到高精度的识别要求。
l 增值税发票识别：通过对增值税发票图片预处理、表格提取、文字提取、文字识别、结构化信息输出等一系列技术化手段，快速将增值税发票上的文字信息识别出来，用于后续的进一步处理，节省大量的人工录入成本。
智能物流服务
智能物流是指应用多种优化算法，对物流过程中的存储、装箱、运输、报关等多个环节进行优化配置，提升物流作业效率。当前，智能物流服务提供了智能装车、路径规划和报关遵从检测、运输路径规划、出库拣货路径规划等五个子服务。
l 智能装车：提供发货之前的箱单预估，根据用户的箱单数据，计算最优摆放，减少空间浪费，保证装箱安全。
l 路径规划：通过提货规划，合理分配租赁车辆，提高车辆满载率、减少出行次数。并对提货路线进行优化，利用中转仓减少例外费用，提升发货效率。
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
1
l 报关遵从检测：采用了统计方法、滑动窗口平均算法，经过线性代数库的加速，达到低响应时延的要求，可识别出时间序列数据中可能的异常值，目前较多用于海关价格申报异常智能化检测。
l 运输路径规划：通过对车辆路径的优化，提高车辆装载率、减少出行次数和运行总里程，控制运输成本。
l 出库拣货路径规划：优化仓库出库拣货路径，提高拣货效率，节省成本。
模糊图像高清重建服务
模糊图像高清重建是指对质量不佳的图像进行一系列的增强与重建技术手段，从而有效改善图像质量。当前，模糊图像高清重建服务提供了低光照增强、图像去雾、超分图像重建3个子服务。
l 低光照增强：主要解决的是夜晚或光线暗区域拍摄的图像导致人眼或机器“看不清”暗光区域的场景。低光照增强可以将图像的暗光区域增强，使得原来人眼不可见区域变得可见，突显图像中的有效视觉信息。
图 1-1 低照度增强前后对比图
l 图像去雾：主要解决雾霾对成像质量的影响。摄像机在雾霾天气拍摄照片或视频时，不可避免出现图像/视频质量不高，拍摄场景不清晰的情况。图像去雾算法除了可以去除均匀雾霾外，还可以处理非均匀的雾霾。
图 1-2 图像去雾前后对比图
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
2
l 超分图像重建：主要解决图像在成像过程中像素过少导致的视觉信息不够或者由于压缩导致的图像信息丢失的场景。超分图像重建基于深度学习算法，对图像中缺失的视觉信息进行补充，使得图像视觉效果更好。
图 1-3 超分图像重建前后对比图
内容检测服务
随着互联网的飞速发展和信息量猛增，大量色情、暴力、政治敏感等不良信息夹杂其中，若不做好内容检测，不良内容会让用户产生反感，从而降低产品使用频率，最终远离产品。内容检测服务对用户上传的图片、文字、视频进行内容检测，自动识别涉黄、暴恐，政治敏感信息。目前内容检测服务提供了图像检测子服务。
l 图像检测：利用深度神经网络模型对图像违规内容进行预测，准确识别图像中涉黄内容，将违规信息扼杀在萌芽状态。
图 1-4 图像检测示例图
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
3
图像识别服务
图像识别，是指利用计算机对图像进行处理、分析和理解，以识别各种不同模式的目标和对象的技术。当前图像识别服务提供了图像标签和翻拍识别2种子服务。
l 图像标签：自然图像的语义内容非常丰富，一个图像包含多个标签内容，图像标签服务可识别三千多种物体以及两万多种场景和概念标签，更智能、准确的理解图像内容，让智能相册管理、照片检索和分类、基于场景内容或者物体的广告推荐等功能更加精准。
图 1-5 图像标签示例图
l 翻拍识别：翻拍识别是定制化图像识别的一种，基于深度学习技术及大规模图像训练，翻拍识别服务可准确识别出商品标签图片是原始图片，还是经过二次翻拍、打印翻拍等手段处理的非合规图片，帮助用户打造智能化业务系统，减少人力成本。
1.2 应用场景
目前，华为人工智能服务支持文字识别、智能物流、模糊图像高清重建、内容检测、图像识别等5类服务。
文字识别服务
单据识别和增值税发票识别，可用于检测与识别多种海关单据、增值税发票图像中的文本、数值、金额、币种等字符，并转换为计算机可读取的字符格式，方便用户自动采集关键数据，提升业务流程自动化比例、提高业务效率和降低人力成本。应用于海关报关、企业报销和金融行业和互联网企业等场景。
智能物流服务
智能物流中智能装车和路径规划可用于物流发货送货场景，解决发货配送过程中出现的车辆预估以和路线规划不合理等问题，提升运输效率，节约成本。同时，报关遵从检测可用于海关价格申报过程中对价格数据异常的自动识别，方便用户及时识别风险、做好防范，提高业务效率和降低人力成本。出库拣货路径优化可优化仓库出库拣货路径，提高拣货效率，节省成本。
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
4
模糊图像高清重建服务
模糊图像高清重建可用于视频监控场景，解决监控摄像头在夜晚、雾霾天气拍摄质量不高以及摄像头本身像素分辨率不够的情形，提升模糊图像的可辨识度，提高后续图像内容识别的效果。
内容检测服务
内容检测用于需要快速高效地对大量网络存储内容进行检测，将违规信息遏制在萌芽状态，避免客户陷入法律纠纷。需要实时地对社交平台内容进行检测，需要不间断地对直播平台内容进行检测的场景，可以节省大量人力开销，提升检测的及时性与准确率。
图像识别服务
图像识别能有效检测出图片中常见的物体，让智能相册管理、照片检索和分类等功能更加直观，精准识别图片中的场景，让基于场景内容的广告推荐等功能更加高效，自动分析图片物体的属性标签，使得添加搜索、筛选等功能更轻松，方便管理大型图片库。
1.3 与其他云服务的关系
统一身份认证服务
统一身份认证（Identity and Access Management，简称IAM）服务，IAM为人工智能服务提供了用户认证和鉴权功能。IAM的更多信息请参见《统一身份认证服务用户指南》。
云监控服务
云监控服务（Cloud Eye Service，简称CES）可以监控人工智能服务的相关指标，具体如表1-1所示。用户可以通过指标及时了解人工智能服务的使用情况，CES的更多信息请参见《云监控服务用户指南》。
表 1-1 AIS 的监控指标
指标名称 指标含义 取值范围 测量对象
调用服务成功次数 该指标用于统计用户请求服务成功次数，以“次”为单位。
≥0次 人工智能服务
调用服务失败次数 该指标用于统计用户请求服务失败次数，以“次”为单位。
≥0次 人工智能服务
说明
每个子服务都有调用成功次数和失败次数两个指标。
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
5
对象存储服务
对象存储服务（下文简称OBS）是稳定、安全、高效、易用的云存储服务。人工智能服务大多数接口都涉及到对用户的数据处理，用户的大量数据采用OBS批量方式处理，可以提升云上的处理的总体效率。
人工智能服务部分接口支持从OBS上采用临时授权的方式获取数据并进行处理。有关OBS的详细信息，请参见：《对象存储服务接口参考》以及《对象存储服务开发指南》。
人工智能服务用户指南 1 简介
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
6
2 如何使用
AIS提供了Web化的服务管理平台，即管理控制台，以及基于HTTPS请求的API管理方式。AIS以开放API的方式提供给用户，用户需要将AIS集成到第三方系统后才可使用。
用户需要先在管理控制台开通AIS，使用第三方系统调用API后即可使用服务，具体流程如下：
步骤1 申请服务
用户可通过管理控制台申请服务，具体操作请参见申请服务。
服务只需要开通一次即可，后面使用时无需再申请。
步骤2 获取请求认证
调用AIS的API有如下两种认证方式，请任选其中一种进行认证鉴权。
l Token认证：通过Token认证调用请求。
l AK/SK认证：通过AK/SK加密调用请求。AK/SK认证安全性更高。
具体操作请参见《人工智能服务接口参考》。
步骤3 调用API
AIS以API的方式提供服务，具体操作请参见调用API。
步骤4 查看服务使用信息
l 用户可以在AIS控制台查看服务调用成功的次数。
l 用户可以在CES控制台查看服务调用成功的次数和失败的次数等历史数据。
具体操作请参见查看服务使用信息。
----结束
人工智能服务用户指南 2 如何使用
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
7
3 约束限制
文字识别
l 单据识别
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP、TIFF格式的图片。
– 图片尺寸不小于1000×1200。– 目前只支持英文海关单据识别。
– 目前不保证API调用的并发能力。
l 增值税发票识别
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP、TIFF格式的图片。
– 图片尺寸不小于1000×500。– 图像中发票区域有效占比超过80%。
– 发票旋转倾斜角度不超过10度。
– 只支持RGB三通道，24位深的彩色图像。
– 图片中发票宽高比例与真实发票比例一致。
– 目前只支持中华人民共和国境内的增值税发票识别。
– 目前不保证API调用的并发能力。
智能物流
l 智能装车
– 只支持“中国华北区”。
– 按智能装车的JSON参数格式约束输入数据，具体参考《人工智能服务接口参考》中3.5.1节智能物流-智能装车。
– 目前不保证API调用的并发能力。
l 路径规划
– 只支持“中国华北区”。
– 按路径规划的JSON参数格式约束输入数据，具体参考《人工智能服务接口参考》中3.5.2节智能物流-路径规划。
– 目前不保证API调用的并发能力。
人工智能服务用户指南 3 约束限制
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
8
l 报关遵从检测
– 只支持“中国华北区”。
– 按报关遵从检测的JSON参数格式输入数据，具体参考《人工智能服务接口参考》中3.5.3节智能物流-报关遵从检测。
– 目前不保证API调用的并发能力。
l 运输路径规划服务
– 只支持“中国华北区”。
– 运输路径规划的JSON参数格式输入数据，具体参考《人工智能服务接口参考》中3.5.4节智能物流-运输路径规划。
– 目前不保证API调用的并发能力。
– 服务请求body数据大小不超过4M。
l 出库拣货路径规划服务
– 只支持“中国华北区”。
– 出库拣货路径规划的JSON参数格式输入数据，具体参考《人工智能服务接口参考》中3.5.5节智能物流-出库拣货路径规划。
– 目前不保证API调用的并发能力。
– 服务请求body数据大小不超过4M。
模糊图像高清重建
l 低光照增强
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 图像尺寸不超过4096×2160。
– 只支持图像深度为24或32。
– 不支持处理压缩比超过25的高度有损压缩图片。
– 目前不保证API调用的并发能力。
l 图像去雾
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 图像尺寸不超过1280×720。
– 只支持图像深度为24或32。
– 不支持处理压缩比超过25的高度有损压缩图片。
– 目前不保证API调用的并发能力。
l 超分图像重建
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 图片尺寸不超过800×600。
– 放大尺度只支持3倍和4倍放大。
– 只支持图像深度为24或32。
– 目前不保证API调用的并发能力。
人工智能服务用户指南 3 约束限制
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
9
内容检测
l 图像检测
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 只支持涉黄类违规信息。
– 目前不保证API调用的并发能力。
图像识别
l 图像标签
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 目前不保证API调用的并发能力。
l 翻拍识别
– 只支持“中国华北区”。
– 只支持识别PNG、JPEG、BMP格式的图片。
– 目前不保证API调用的并发能力。
人工智能服务用户指南 3 约束限制
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
10
4 业务操作
4.1 申请服务
前提条件
申请华为云账号，并完成实名认证。
操作场景
用户第一次使用人工智能服务时，需要先申请公测并开通该服务。服务只需要开通一次即可，后面使用时无需再申请。
操作步骤
步骤1 申请华为云账号，登录管理控制台。
步骤2 单击“服务列表”，选择“数据分析 > 人工智能服务”，进入“人工智能服务”界面。
步骤3 根据业务需求，单击左侧导航栏对应的服务类型,例如：“文字识别”，进入服务申请页面。
步骤4 由于当前服务处于公测阶段，单击“申请公测”，进行服务公测申请。
步骤5 完成服务公测申请之后，单击“申请服务”，在弹出页面中单击“确定”，即可完成该服务的开通操作。
步骤6 服务开通后，在“总览”页面，可以查看到已开通服务相关信息。
----结束
4.2 调用 API
4.2.1 构造请求方法
人工智能服务以API的方式提供服务，用户可以通过API方式单独或集成到业务程序使用人工智能服务。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
11
本章节介绍如何填充请求参数、构建请求方法。每一个请求通常由三部分组成：请求行、请求消息头、请求消息体。
请求行
请求行以一个方法符号开头，以空格分开，后面跟着请求的URI和协议的版本，格式如下：Method Request-URI HTTP-Version CRLF
l Method：表示请求方法（所有请求方法为大写字母格式），各个方法的解释如下：
– GET：请求获取Request-URI所标识的资源。
– POST：在Request-URI所标识的资源后附加新的数据。
– PUT：请求服务器存储一个资源，并用Request-URI作为其标识。
– DELETE：请求服务器删除Request-URI所标识的资源。
– PATCH：请求服务器更新资源的部分内容，当资源不存在的时候，PATCH可能会去创建一个新的资源。
– HEAD：只请求页面的首部。
– OPTION：允许客户端查看服务器的性能。
l Request-URI：是一个统一资源标识符。
Request-URI中的参数分别为“[path][?query]”，其中：
– 多个path之间使用“/”分隔。
– query与path之间使用“?”分隔，多个query之间使用“&”分隔。
l HTTP-Version：表示请求的HTTP协议版本。
l CRLF：表示回车和换行。除了作为结尾的CRLF外，不允许出现单独的CR或LF字符。
请求消息头
请求消息头由若干头域构成，每个头域由一个域名、冒号（:）和域值组成。
AIS的请求消息头有使用Token或使用AK/SK两种方式。
l 使用Token方式请求消息头如表4-1所示。
表 4-1 Token 方式请求消息头
消息头名称 是否必选 类型 说明
X-Auth-Token 是 String 用户从IAM请求得到的Token。
Content-Type 否 String 资源内容的类型。
l 如果图像文件以Base64编码字符串形式，请求字段为必填项，且值为“application/json”。
l 如果图像以文件方式请求，则无须添加Content-Type。
默认值：无。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
12
l 使用AK/SK方式请求消息头如表4-2所示。
表 4-2 AK/SK 方式请求消息头
消息头名称 是否必选 类型 说明
Content-Type 是 String 资源内容的类型。
l 如果文件以Base64字符串形式，请求字段为必填项，且值为“application/json”。
l 如果图片以文件方式请求，则无须添加Content-Type。
默认值：无。
X-Sdk-Date 是 String 请求发起端的日期和时间，取值为当前系统的GMT时间，格式为“YYYYMMDD'T'HHMMSS'Z'”，例如“20150907T101459Z”。
默认值：无。
Authorization 是 String 请求消息中的签名认证信息，该值来源于请求签名结果，请参见《人工智能服务接口参考》。
例如“SDK-HMAC-SHA256Credential=ZIRRKMTWPTQFQI1WKNKB/20150907//ec2/sdk_request,SignedHeaders=content-Type;host;x-sdk-date,Signature=55741b610f3c9fa3ae40b5a8021ebf7ebc2a28a603fc62d25cb3bfe6608e1994”。
默认值：无。
Host 是 String 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。例如“code.test.com”、“code.test.com:443”。
请求消息体
以JSON格式封装，基本语法是嵌套式的“key:value”形式。HTTP请求的正文针对不同的URI对象有不同的必须字段和可选字段。示例如下：POST https://{endpoint}/v1.0/ocr/action/ocr_form Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG Request Body: {
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
13
"image":"MTExMTExMTExMTExMTExMTExMTExMTExMTExMTExMTEx..."}
4.2.2 发起请求
共有三种方式可以基于已构建好的请求消息发起请求。
l cURL
cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。
l 编码
通过编码调用接口，组装请求消息，并发送处理请求消息。
l REST客户端
Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。
– 针对Firefox，请参见Firefox REST Client。– 针对Chrome，请参见Chrome REST Client。
4.2.3 解析响应消息
请求消息接收之后，服务器会返回一个HTTP响应消息。
响应也是由三个部分组成：状态行、响应头、响应消息体。
状态行
状态行格式如下：
HTTP-Version Status-Code Reason-Phrase CRLF
l HTTP-Version：表示服务器HTTP协议的版本号。
l Status-Code：表示服务器返回的响应状态代码，具体请参见状态码。
状态代码有三位数字组成，第一个数字定义了响应的类别，且有五种可能取值：
– 1xx：指示信息，表示请求已接收，继续处理。
– 2xx：成功，表示请求已被成功接收、理解、接受。
– 3xx：重定向，要完成请求必须进行更进一步的操作。
– 4xx：客户端错误，请求有语法错误或请求无法实现。
– 5xx：服务器端错误，服务器未能实现合法的请求。
l Reason-Phrase：表示状态代码的文本描述。
响应消息头
响应的消息头如表4-3所示。
表 4-3 公共响应消息头
名称 类型 描述
Content-Length String 响应消息体的字节长度，单位为Byte。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
14
名称 类型 描述
Date String 系统响应的时间，例如“Mon, 15 Jul 201321:08:05 GMT”。
Content-Type String 响应消息体的MIME类型，例如“application/json”。
响应消息体
响应消息体为JSON格式的文本，并且输出内容是UTF-8编码格式，例如：
{ result": { "wordsArray": [ { "index": 1, "words": "TECH INVESTMENT CO LTD" }, { "index": 2, "words": "HC" }, { "index": 3, "words": "METHOD" }] }}
4.2.4 状态码
状态码 编码 状态说明
100 Continue 继续请求。
这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。
101 Switching Protocols 切换协议。只能切换到更高级的协议。
例如，切换到HTTP的新版本协议。
200 OK 服务器已成功处理了请求。
201 Created 创建类的请求完全成功。
202 Accepted 已经接受请求，但未处理完成。
203 Non-AuthoritativeInformation
非授权信息，请求成功。
204 No Content 请求完全成功，同时HTTP响应不包含响应体。
在响应OPTIONS方法的HTTP请求时返回此状态码。
205 Reset Content 重置内容，服务器处理成功。
206 Partial Content 服务器成功处理了部分GET请求。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
15
状态码 编码 状态说明
300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。
301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。
302 Found 资源被临时移动。
303 See Other 查看其它地址。
使用GET和POST请求查看。
304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。
305 Use Proxy 所请求的资源必须通过代理访问。
306 Unused 已经被废弃的HTTP状态码。
400 Bad Request 非法请求。
建议直接修改该请求，不要重试该请求。
401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。
402 Payment Required 保留请求。
403 Forbidden 请求被拒绝访问。
返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
404 Not Found 所请求的资源不存在。
建议直接修改该请求，不要重试该请求。
405 Method Not Allowed 请求中带有该资源不支持的方法。
建议直接修改该请求，不要重试该请求。
406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。
407 Proxy AuthenticationRequired
请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。
408 Request Timeout 服务器等候请求时发生超时。
客户端可以随时再次提交该请求而无需进行任何更改。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
16
状态码 编码 状态说明
409 Conflict 服务器在完成请求时发生冲突。
返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。
410 Gone 客户端请求的资源已经不存在。
返回该状态码，表明请求的资源已被永久删除。
411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。
412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。
413 Request Entity TooLarge
由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。
414 Request URI Too Long 请求的URI过长（URI通常为网址），服务器无法处理。
415 Unsupported MediaType
服务器无法处理请求附带的媒体格式。
416 Requested Range NotSatisfiable
客户端请求的范围无效。
417 Expectation Failed 服务器无法满足Expect的请求头信息。
422 Unprocessable Entity 请求格式正确，但是由于含有语义错误，无法响应。
429 Too Many Requests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。
500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。
501 Not Implemented 服务器不支持请求的功能，无法完成请求。
502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。
503 Service Unavailable 被请求的服务无效。
建议直接修改该请求，不要重试该请求。
504 Gateway Timeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
17
状态码 编码 状态说明
505 HTTP Version NotSupported
服务器不支持请求的HTTP协议的版本，无法完成处理。
4.3 查看服务使用信息
操作场景
人工智能服务支持以下方式查看服务使用信息：
l AIS控制台：查看服务调用成功的次数。
l CES控制台：查看服务调用成功和失败的次数等历史数据。
操作步骤
步骤1 登录管理控制台。
步骤2 单击“服务列表”，选择“数据分析 > 人工智能服务”，进入“人工智能服务”界面。
步骤3 用户可通过以下2种方法查看服务调用的次数：
l 单击左侧导航栏上的“总览”，查看所有已申请服务的使用情况。
l 单击左侧导航栏的服务名称，例如：“文字识别”，可以查看服务使用信息。然后，单击“查看监控数据”，进入CES控制台查看服务调用成功和失败的次数等具体信息。
说明
CES的更多信息请参见《云监控服务用户指南》。
----结束
人工智能服务用户指南 4 业务操作
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
18
5 常见问题
5.1 有哪些途径可以使用 AIS 的 API？共有三种方式可以基于已构建好的请求消息发起请求。
l cURLcURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl.haxx.se/。
l 编码
通过编码调用接口，组装请求消息，并发送处理请求消息。
l REST客户端
Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。
– 针对Firefox，请参见Firefox REST Client。– 针对Chrome，请参见Chrome REST Client。
5.2 调用 AIS 的 API 失败时怎么处理？
检查原因
1. 根据API调用返回结果或者错误码查找原因。
2. 检查访问密钥AK/SK是否获取成功。
3. 检查Token是否填写正确或者已过期。
4. 检查API调用方法是否正确。
联系服务人员
如果无法确定原因和解决问题，请联系技术服务人员。
5.3 为什么实际调用次数与界面记录次数不一致？AIS控制台只记录服务调用成功的次数，调用失败的次数不计算在使用量内。
人工智能服务用户指南 5 常见问题
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
19
可按以下方法查看调用失败的次数：
1. 登录管理控制台。
2. 在控制台首页选择“人工智能服务”，进入“人工智能服务”界面。
3. 在左侧导航栏中选择对应的服务（如：“单据识别”），单击进入该服务界面，单击“查看监控数据”，进入CES控制台查看服务调用成功和失败的次数等具体信息。
5.4 为什么有时单据识别的结果会不准确？单据识别的结果不准确时，有以下几个原因：
1. 图片格式不支持。
AIS目前只支持识别PNG、JPG、JPEG、BMP、TIFF格式的图片。
2. 图片尺寸过小。
图片尺寸不小于1000×1200像素。
3. 图片画质太差，例如图片过暗。
4. 图片样式不符合单据样式。
目前AIS只支持英文海关单据识别。
5. 如果有错误码，请参考错误码排查问题。
错误码具体说明请参见《人工智能服务接口参考》。
5.5 是否可以进一步提升图像去雾和低光照处理效果？默认参数可保证在大多数情况下能取得比较好的处理效果，若要进一步提升效果，需要通过调整相关参数，选取最佳效果。
5.6 为什么有时报关遵从检测的结果会不准确？报关遵从检测不准确时（识别出异常点过多或异常点过少），有以下几个原因：
1. 输入数据质量太差。
算法默认异常点是小概率出现的，如果输入数据中异常点的比例过高，会造成算法失效。
2. 参数设置不合理。
参数说明请参见《人工智能服务接口参考》。
3. 如果有错误码。
错误码具体说明请参见《人工智能服务接口参考》。
5.7 为什么智能装车效果较差？智能装车效果较差时，有以下几个原因：
1. 箱子类型较多。
算法考虑的约束条件较多，在箱子类型较多时效果可能不如预期，建议将箱子类型进行筛选。
人工智能服务用户指南 5 常见问题
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
20
2. 参数设置不合理。
算法对参数约束条件较多，需严格按照参数说明输入，具体请参见《人工智能服务接口参考》。
人工智能服务用户指南 5 常见问题
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
21
A 修订记录
发布日期 修改说明
2017-11-23 第六次正式发布。
l 修改
1. 人工智能服务，增加运输路径规划和出库拣货路径规划服务的描述。
2. 应用场景，增加运输路径规划和出库拣货路径规划服务的应用场景描述。
3. 约束限制，增加了运输路径规划和出库拣货路径规划服务的约束限制描述。
2017-11-09 第五次正式发布。
l 修改
1. 人工智能服务，增加增值税发票识别、图像标签和翻拍识别服务的描述。
2. 应用场景，增加增值税发票识别、图像标签和翻拍识别服务的应用场景描述。
3. 约束限制，增加了增值税发票识别、图像标签和翻拍识别服务的约束限制描述。
4. 与其他云服务的关系，增加了对象存储服务的描述。
2017-10-12 第四次正式发布。
2017-9-30 第三次正式发布。
l 修改
1. 人工智能服务，增加内容检测服务的描述。
2. 应用场景，增加内容检测服务的应用场景描述。
3. 约束限制，增加了内容检测服务的约束限制描述。
人工智能服务用户指南 A 修订记录
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
22
发布日期 修改说明
2017-08-20 第二次正式发布。
l 修改：
1. 人工智能服务，增加智能物流服务和模糊图像高清重建服务的描述。
2. 应用场景，增加智能物流服务和模糊图像高清重建服务的应用场景描述。
3. 约束限制，增加智能服务流服务和模糊图像高清重建服务的约束限制描述。
4. 申请服务，修改了服务申请步骤的描述。
5. 查看服务使用信息，修改了查看服务使用信息的描述。
2017-07-30 第一次正式发布。
人工智能服务用户指南 A 修订记录
文档版本 06 (2017-11-23) 华为专有和保密信息版权所有 © 华为技术有限公司
23
![优秀企业如能抓住商用车的机遇 行业深度报告模板 就抓住专用车 …pg.jrj.com.cn/acc/Res/CN_RES/INDUS/2016/5/26/bb08... · 相关研究 [table_report]1、行业深度_特高压：穿透雾霾](https://img.pdfslide.tips/doc/110x75/60355c4a64fea90227575599/cefcecoee-eoe-ce.jpg)
