图像识别(Visual Recognition)

简介

该服务使用深度学习算法来识别场景、物体和人脸。同样,你也可以根据自己的需求来创建并训练你自己的分类器

认证

在bluemix上创建该服务实例,并且获得api-key,具体参见详见Watson使用指南

方法

图片分类(Classify an image)

使用默认分类器,上传图片或图片地址即可进行识别。图片必须是jpg或png格式。对于待识别图片而言,获得的响应包括一些列选定分类器的得分,这些分数从0到1,越高的得分说明越接近该分类器,返回的得分信息是0.5以上的。为了获得最好的识别效果,推荐上传224x224px及以上大小的图片。

参数:

  • api_key (query型,必须,你的API密钥)

  • version (query型,必须,版本信息,当前最新2016-05-20 )

  • images_file (multipart/form-data,必须,图片或压缩包。压缩包最大5MB,最多20张图片)

  • parameters (multipart/form-data,JSON格式数据)

    • url (string型,图片地址)

    • classifier_ids (数组,待使用分类器)

    • owners (数组,分类器拥有者,IBM或你自己)

    • threshold (float型,返回的最小得分)

  • Accept-Language (Header型,输出语言)

import json
from os.path import join, dirname
from os import environ
from watson_developer_cloud import VisualRecognitionV3

visual_recognition = VisualRecognitionV3('2016-05-20', api_key='{api-key}')

print(json.dumps(visual_recognition.classify(images_url=https://www.ibm.com/ibm/ginni/images/ginni_bio_780x981_v4_03162016.jpg), indent=2))

返回结果

参数:

  • images(结果数组)

  • classifiers(分类器数组)

  • classes (分类器中的标签数组)

  • class (分类器标签)

  • score (得分)

  • classifier_id (分类器唯一标识)

  • name (分类器名称)

  • image (图片文件所在路径)

  • source_url (图片来源地址)

  • resolved_url (图片解析地址)

  • images_processed(处理图片数量)

  • error (错误反馈)

  • error_id (错误标识ID)

  • description (错误描述)

  • warnings (警告提示数组)

{
    "images": [
        {
            "classifiers": [
                {
                    "classes": [
                        {
                            "class": "apple",
                            "score": 0.645656
                        },
                        {
                            "class": "fruit",
                            "score": 0.598688
                        },
                        {
                            "class": "food",
                            "score": 0.598688
                        },
                        {
                            "class": "orange",
                            "score": 0.5
                        },
                        {
                            "class": "vegetable",
                            "score": 0.28905
                        },
                        {
                            "class": "tree",
                            "score": 0.28905
                        }
                    ],
                    "classifier_id": "default",
                    "name": "default"
                },
                {
                    "classes": [
                        {
                            "class": "orange",
                            "score": 0.635488
                        }
                    ],
                    "classifier_id": "fruits_1050835757",
                    "name": "fruits"
                },
            ],
            "image": "orange-apple-banana-isolated.jpg"
        },
        {
            "classifiers": [
                {
                    "classes": [
                        {
                            "class": "fruit",
                            "score": 0.916827
                        },
                        {
                            "class": "vegetation",
                            "score": 0.768525
                        },
                        {
                            "class": "market",
                            "score": 0.768525
                        },
                        {
                            "class": "food",
                            "score": 0.377541
                        },
                        {
                            "class": "mercado",
                            "score": 0.28905
                        },
                        {
                            "class": "vegetable",
                            "score": 0.268941
                        }
                    ],
                    "classifier_id": "default",
                    "name": "default"
                },
                {
                    "classes": [
                        {
                            "class": "apple",
                            "score": 0.541237
                        }
                    ],
                    "classifier_id": "fruits_1050835757",
                    "name": "fruits"
                },
            ],
            "resolved_url": "https://c1.staticflickr.com/9/8803/17306765722_a2d0
be2f9e_b.jpg",
            "source_url": "https://flic.kr/p/snkGus"
        }
    ]
    "images_processed": 2
}

人脸识别(Detect faces)

分析图片中的人脸信息,比如近似年龄、性别、如果是名人还有姓名。支持jpg或png格式。该功能是不能训练的,并且不能用于生物学脸部识别。

参数:

  • api_key (query型,必须,你的API密钥)

  • version (query型,必须,版本信息,当前最新2016-05-20 )

  • images_file (multipart/form-data,必须,图片或压缩包。压缩包最大5MB,最多20张图片)

  • parameters (multipart/form-data,JSON格式数据,图片地址)

import json
from os.path import join, dirname
from os import environ
from watson_developer_cloud import VisualRecognitionV3

visual_recognition = VisualRecognitionV3('2016-05-20', api_key='{api_key}')

print(json.dumps(visual_recognition.detect_faces(images_url=https://www.ibm.com/ibm/ginni/images/ginni_bio_780x981_v4_03162016.jpg), indent=2))

返回结果

参数:

  • images (结果数组)

  • faces (脸部信息数组)

  • age (年龄信息)

    • max (可能最大年龄)

    • min (可能最小年龄)

  • face_location (识别区域)

    • height (识别区域高度)

    • left(识别区域左上角x坐标)

    • top (识别区域左上角y坐标)

    • width (识别区域宽度)

  • gender (性别信息)

  • identity (如果是名人,返回信相关息,否则返回空)

    • name (识别人物的姓名)

    • type_hierarchy (关于名人,找到其属于的层次类型)

  • score (得分)

  • image (图片路径)

  • source_url (来源地址)

  • resolved_url (图片解析地址)

  • images_processed(处理图片数量)

  • error (错误反馈)

  • error_id (错误标识ID)

  • description (错误描述)

  • warnings (警告提示数组)

{
    "images": [
        {
            "faces": [
                {
                    "age": {
                        "max": 54,
                        "min": 45,
                        "score": 0.372036
                    },
                    "face_location": {
                        "height": 75,
                        "left": 256,
                        "top": 93,
                        "width": 67
                    },
                    "gender": {
                        "gender": "MALE",
                        "score": 0.99593
                    },
                    "identity": {
                        "name": "Barack Obama",
                        "score": 0.989013,
                        "type_hierarchy": "/people/politicians/democrats/barack
obama"
                    }
                }
            ],
            "image": "prez.jpg"
        }
    ],
    "images_processed": 1
}
}

文档原文:http://www.ibm.com/watson/dev...


阿然
32 声望10 粉丝

如果你问我问题,我会给你一个有效,全面,精彩的回复。


引用和评论

0 条评论