任务目的

这一步会对腾讯云的图像分析模块进行介绍和说明，完成这一步的操作后，学员可以熟悉腾讯云图像分析的主要功能，掌握图像分析API的调用方法，熟悉腾讯云API 3.0 Explorer的使用。

在此任务中，首先会展示图像分析的demo界面，帮助学员理解本实验要完成的具体页面效果，分析实验中需要实现的主要功能。接下来会介绍图像分析API以及图像质量评估接口，帮助学员理解图像分析的各项功能，以及图像质量评估接口中涉及到的主要参数。最后会介绍API 3.0 Explorer，借助此页面可以在线调用图像质量评估API，预览数据格式，同时可以快速生成实验所需的API调用代码。

任务步骤

1.图像分析demo页面介绍

此实验参考了腾讯云的 图像分析demo页面 ，在腾讯云展示的图像分析demo页面中，同时包含了文本识别（通用文字识别、卡证文字识别等）与图像分析（图像理解、图像处理、图像质量检测）的功能：

如果想要体验腾讯云AI的更多功能，还可以翻到页面下方，扫描页面中【腾讯云AI体验中心】小程序的二维码，进入微信小程序体验腾讯云AI实现的各种功能。

如果学员有兴趣，可以在完成本实验后参考实验中的代码，独立完成其他AI功能的Web页面开发。由于本实验主要展示图像质量检测功能的使用，所以接下来将会围绕本实验要完成的图像质量检测的demo页面进行介绍。

(1)访问图像质量评估demo页面。

访问图像分析的 demo页面地址 ，可以看到图像分析的展示界面，点击上方的【图像质量检测】按钮，可以进入图像质量检测的展示页面：

此页面可以对实例图片、本地图片以及图片URL地址进行图像质量检测。

(2)页面功能演示与说明。

本项目会模仿此页面的部分功能，接下来对将会实现主要功能进行展示说明：

• 进入页面时，会自动检测左上方缩略图的第一张，点击其他的缩略图，下方的预览图会自动同步，同时后台会进行图像分析，并在右侧展示图像质量检测结果：

• 点击右侧的【上传本地照片】按钮，可以上传本地图片到demo页面，同样也会展示图像质量检测结果：

• 在右上方的文本框中输入图片的URL地址，并点击【检测】按钮，可以对网络中的图片进行图像质量检测：

• 下方的信息展示框中除了可以展示识别结果，还可以展示页面的请求（Request）和响应（Response）信息：

通过这一部分的内容，学员可以了解图像质量检测demo页面的主要功能，以及接下来实验项目准备实现的功能说明。下一部分将会对实验中需要用到的核心产品——图像分析API进行介绍。

2.图像分析API介绍

(1)文档中心与图像分析文档介绍。

本实验中需要用到图像分析的API，想要了解图像分析的具体功能，可以参考 图像分析官方文档 。对于腾讯云的各种产品，都可以通过访问腾讯云的 文档中心 获取对应产品的文档信息。

文档中会对图像分析的产品、购买、操作和API进行详细的介绍，通过此页面可以帮助开发者快速了解图像分析产品的相关信息。

本实验中需要查看图像质量评估的API文档，如果希望访问对应页面，可以点击页面左侧导航栏中的【API文档】-【图像质量检测相关接口】-【图像质量评估】按钮，跳转到图像质量评估的API文档页：

(2)图像质量评估API主要参数说明。

在图像质量评估的 API文档 中，已经对此接口的相关参数进行了详细的说明，下面将会重点介绍公共参数以外主要输入参数和输出参数。

注：关于公共参数的具体说明，可以参考 公共参数 官方文档。

输入参数说明：

输出参数说明：

3.图像分析功能的开通

如果想要调用腾讯云的图像分析API，需要先在腾讯云控制台开通图像分析，开通方式如下：

访问 图像分析控制台 ，第一次进入无法直接使用，需要先点击【立即开通】按钮完成功能开通：

开通服务需要等待约一分钟的时间，期间页面展示效果如下：

学员可以在约一分钟后尝试刷新页面，确认功能已经成功开通。开通成功后，将会跳转到产品页，并在页面中展示接口的统计数据：

注：开通了图像分析的某项服务，该项服务即可享受10000次/月的免费调用额度，以免费资源包的形式在每个月1号自动发放到腾讯云账号中。如果开通了多项图像分析服务的客户，各项服务均可享受10000次/月的免费调用额度。超出免费调用额度的部分需要进行收费，详细的收费标准可以参考 图像分析计费概述。

完成这一部的功能开通操作后，便可以进行图像分析API的调用。

4.API 3.0 Explorer说明

(1)API 3.0 Explorer简介。

在进行项目的开发前，可以通过腾讯云官方提供的 API 3.0 Explorer 进行接口的调用尝试，调用成功后还可以直接复制页面生成的API调用代码，并直接在项目中使用。

点击上方的链接会进入图像分析API的控制台，界面展示效果及主要功能说明如下：

API Explorer提供了在线调用、签名验证、SDK代码生成和快速检索接口等能力。是一款非常强大的API调用工具，学员如有调用腾讯云产品中的其他API的需求，也可以借助此工具实现。

接下来将会通过此工具调用图像质量评估接口，并生成接口调用的请求代码。

(2)在线调用API尝试。

为了方便展示API请求的参数和返回结果，此处会在API 3.0 Explorer中对图像质量评估API的调用过程进行展示。

首先在API 3.0 Explorer中填写好个人密钥和所需参数，此例中的参数为Region（地域）和待分析图像（URL地址或Base64编码，此处使用URL地址进行展示）。然后在右侧选择【在线调用】，点击下方的【发送请求】按钮，如果输入信息无误，即可查看图像质量评估的返回结果。图像质量评估请求尝试的示意图展示如下：

学员可以自行尝试进行请求发送，查看请求的分析结果。

注：此处的API请求等同于真实的请求操作，会消耗对应功能的请求次数，图像分析的相关API提供10000次/月的免费调用额度。

(3)获取Python请求代码。

如果上方的操作中能够顺利获取请求结果，说明图像质量评估API的调用功能已经实现。此时可以点击【代码生成】按钮，再点击【Python】按钮，获取请求代码：

获取到的代码可以复制到Python项目中，用于实现图像质量评估的功能。

如果希望获取与在线调用相同的结果，可以直接复制上方的代码。对于本例需要实现的Python项目，会针对部分参数以及签名方法进行少量调整。在接下来的任务中，会对项目代码进行详细介绍。