使用智能媒体管理（IMM）快速搭建图片分类服务

2021-10-02 04:35:31

概述

在服务构建中，我们经常需要对用户的图片做进一步分析。本文利用智能媒体管理（IMM）提供的图片索引功能，快速搭建一个图片分类的功能，示例使用 PHP 语言实现。

我们以新闻场景为例。用户上传了若干体育运动相关图片，我们需要按照运动的类别进行分类管理。操作流程如下：

将图片传入 OSS 存储中。
创建一个媒体集 Set，用于存储这些图片的 元数据。
将图片索引至 Set 内。
按照标签进行搜索。

如下图：

下面我们分步操作一下。

创建 IMM 项目

开通 IMM 服务后，访问控制台，在左侧点击加号创建一个新项目。

左上方地域我们选择 华东1（杭州），右侧的项目名称命名为 ImageClassifyDemo ，所属地域选择 华东1（杭州） ，类型选择 图片标准型 ，QPS 填入 1 ，点击下一步。

截止本文发表时，图片标准型的 1 QPS 是免费的，可以放心测试。参考计费说明

准备测试图片

我们准备了6张测试图片：

oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-00.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-02.jpg

您可以将地址改为 http 路径以在浏览器打开查看。如

https://imm-user-wmt-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/image-classify-demo/soccer-02.jpg

您也可以自己准备图片。请将图片上传至 OSS 中，并确保 OSS 的 Bucket 桶和第一步创建的 IMM 项目在同一个地域。

开始使用

下载并安装最新版本阿里云 PHP SDK 。

复制如下代码，并填入您的 AccessKey 和 AccessSecret 。您可以在阿里云用户控制台获取。

若您使用和本文不同的项目名称、地域、图片等，请修改示例代码中的对应部分。

<?php
// 将本文件置入 SDK 的同目录下
include_once './aliyun-php-sdk-core/Config.php';
use imm\Request\V20170906 as Imm;

// 填入您的阿里云 AccessKey 和 AccessSecret
const AccessKey = ""; 
const AccessSecret = ""; 
// 填入服务开通地域，这里以杭州区域为例
const Region = "cn-hangzhou";
// 填入创建好的 Project 名称
const Project = "ImageClassifyDemo";
// 填入刚上传好的图片 URL，注意替换为自己的 bucket
const Images = [
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg",
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg",
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg",
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-00.jpg",
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-01.jpg",
    "oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-02.jpg",
];

//初始化客户端
$iClientProfile = DefaultProfile::getProfile(
    Region,
    AccessKey,
    AccessSecret
);
$client = new DefaultAcsClient($iClientProfile);

//创建媒体集 Set
$setId = "image-classify-demo";
$request = new Imm\CreateSetRequest();
$request->setProject(Project);
$request->setSetId($setId);
try {
    $response = $client->getAcsResponse($request);
    print_r("Create set response:\n");
    print_r($response);
} catch (ServerException $e){
    print_r("Create set failed:\n");
    print_r($e);
}


//将图片添加到媒体集
foreach (Images as $OSSURI) {
    //由于我们开通 Project 时选择的是限时免费的 1 CU
    //因此在循环时增加 sleep 来避免超过请求频率限制
    sleep(1);
    $request = new Imm\IndexImageRequest();
    $request->setProject(Project);
    $request->setSetId($setId);
    $request->setImageUri($OSSURI);
    $response = $client->getAcsResponse($request);
    print_r("Index image $OSSURI response:\n" );
    print_r($response);
}

//等待索引完成
sleep(5); 

//统计下媒体集内的标签数量
$request = new Imm\ListSetTagsRequest();
$request->setProject(Project);
$request->setSetId($setId);
$response = $client->getAcsResponse($request);
print_r("List tags in set response:\n" );
print_r($response);

//获取所有标签为 打篮球 的图片
$request = new Imm\FindImagesByTagNamesRequest();
$request->setProject(Project);
$request->setSetId($setId);
$request->setTagNames(json_encode(["打篮球"]));
$response = $client->getAcsResponse($request);
print_r("Images with tag \"打篮球\" response:\n" );
foreach ($response->Images as $image) {
    // 这里仅把搜索到的图片 URI 输出
    print_r($image->ImageUri . "\n");
}
//如果想看到更详细的图片信息，可以直接打印 $response
//print_r($response);

随后运行该文件，即可看到返回结果。

代码解析

该段代码主要分为 4 步操作。

创建媒体集 Set

这一步帮助我们在 IMM 的项目中，新建了一个媒体集 Set 。这个 Set 用于保存我们接下来要索引的图片的 元数据 ，即标签、人脸、OCR 等等信息。

这一步正确的输出如下。我们可以看到成功创建了一个叫做 image-classify-demo 的 Set。

CreateSet API 官方文档

Create set response:
stdClass Object
(
    [RequestId] => 6B49F679-9ABF-460B-93F3-1941CD5E29E3
    [CreateTime] => 2019-01-16T11:09:23.658Z
    [SetName] => 
    [ModifyTime] => 2019-01-16T11:09:23.658Z
    [SetId] => image-classify-demo
)

将图片索引至媒体集 Set

这一步将我们的图片添加至媒体集。

正确输出如下，仅用一张图片的输出示例。

IndexImage API 官方文档

Index image oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg response:
stdClass Object
(
    [RequestId] => 79F320DB-1985-45F5-A1F6-FBAB4B1726F2
    [CreateTime] => 2019-01-16T11:09:24.706Z
    [ModifyTime] => 2019-01-16T11:09:24.706Z
    [SetId] => image-classify-demo
    [RemarksA] => 
    [ImageUri] => oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg
    [RemarksB] => 
)

至此我们的智能媒体集的元数据已经构建完毕了。后面是如何利用元数据进行查询。

获取媒体集 Set 内的标签列表

这一步可以获取到媒体集 Set 内图片的标签列表，及其计数。

正常返回值如下。我们注意到结果是按标签出现次数降序排序的。出现的最多的标签是“体育运动”，出现了 6 次。

ListSetTags API 官方文档

List tags in set response:
stdClass Object
(
    [Tags] => Array
        (
            [0] => stdClass Object
                (
                    [TagCount] => 6
                    [TagName] => 体育运动
                )
            [1] => stdClass Object
                (
                    [TagCount] => 6
                    [TagName] => 球类
                )
            [2] => stdClass Object
                (
                    [TagCount] => 3
                    [TagName] => 打篮球
                )
            [3] => stdClass Object
                (
                    [TagCount] => 3
                    [TagName] => 踢足球
                )
        )
    [RequestId] => 6D5294A6-2B77-4C86-8857-EAF8EF57D361
    [SetId] => image-classify-demo
)

根据标签筛选图片

最后一步我们筛选所有“打篮球”的图片。

正常返回值如下。正确筛选出了 3 张图片。

FindImagesByTagNames API 官方文档

Images with tag "打篮球" response:
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg

当然 元数据 不止有标签，还有人脸等更多信息。可以取消上述代码最后一行的注释来查看全部结果。

以上就是利用智能媒体管理（IMM）快速实现了一个图片分类的 DEMO 。如有任何问题可以联系服务同学。

码农公寓

概述