图片分析接口
所有文档

          媒体内容分析 MCA

          图片分析接口

          提交图片分析(同步)

          用户提供图片URL或BOS路径,进行图片分析。

          该接口为同步接口,即直接在HTTP response body中返回图片分析结果。

          请求语法

          PUT /v{version}/image?sync HTTP/1.1
          host: vca.bj.baidubce.com
          authorization: <bce-authorization-string>
          content-type: application/json

          请求参数

          参数 类型 描述 是否必须
          sync String 标志参数,无须取值

          请求体

          参数 类型 描述 是否必须
          source String 图片url
          preset String 图片分析模版 否,不设置时使用默认图片模版
          title String 标题, 长度不超过256

          说明:

          1. 对于BOS图片,source="bos://<bos-bucket>/<bos-object>”,例如"bos://testbucket/dir/image.jpg”,用户需要确保bos路径可访问。
          2. 对于url图片,source="http://domain.com/dir/image.jpg",目前仅支持http协议url,用户需要确保该url外网可访问。

          请求示例

          提供图片BOS路径进行分析:

          PUT /v1/image?sync HTTP/1.1
          host: vca.bj.baidubce.com
          content-type: application/json
          authorization: <bce-authorization-string>
          
          {
              "source": "bos://demo_bucket/demo_image.jpg"
          }

          提供图片URL进行分析:

          PUT /v1/image?sync HTTP/1.1
          host: vca.bj.baidubce.com
          content-type: application/json
          authorization: <bce-authorization-string>
          
          {
              "source": "http://domain.com/dir/image.jpg"
          }

          v1v2均支持。

          响应头域

          响应体

          参数 类型 描述
          source String 图片url
          preset String 模版
          title String 标题
          results List 结果列表,仅仅当status=FINISHED时返回
          + type 枚举,CHARACTER/TAG 结果类型
          + data String 结果详情
          error Object 失败结果,仅仅当status=Error时返回
          + code String 失败码
          + message String 失败详情

          对于结果类型是CHARACTER,data反序列化后为数组,数组元素结构为:

          参数 类型 描述
          word String 文本
          confidence Double 置信度
          location Object 位置
          + leftOffsetInPixel Interger 左上角横坐标
          + topOffsetInPixel Interger 左上角纵坐标
          + widthInPixel Interger
          + heightInPixel Interger

          对于结果类型是TAG,data反序列化后为数组,数组元素结构为:

          参数 类型 描述
          type String 标签类型
          result List 标签列表
          + attribute String 标签
          + confidence Double 置信度
          + source Double 标签来源
          + location Object 位置,仅仅当type=figure/logo时返回
          ++ leftOffsetInPixel Interger 左上角横坐标
          ++ topOffsetInPixel Interger 左上角纵坐标
          ++ widthInPixel Interger 宽度
          ++ heightInPixel Interger 高度
          ++ degree Interger 角度,仅仅当type=figure时返回

          响应示例

          分析成功时返回:

          HTTP/1.1 200 OK    
          
          {
              "preset":"default",
              "results":[
                  {
                      "data":"[{\"word\":\" CCTV 13\",\"location\":{\"leftOffsetInPixel\":25,\"topOffsetInPixel\":21,\"widthInPixel\":50,\"heightInPixel\":13},\"confidence\":100.0},{\"word\":\"新\",\"location\":{\"leftOffsetInPixel\":38,\"topOffsetInPixel\":36,\"widthInPixel\":26,\"heightInPixel\":11},\"confidence\":98.09},{\"word\":\"习近平在中国政法大学考察时强调\",\"location\":{\"leftOffsetInPixel\":86,\"topOffsetInPixel\":207,\"widthInPixel\":223,\"heightInPixel\":14},\"confidence\":99.97},{\"word\":\"立德树人德法兼修抓好法治人才培养\",\"location\":{\"leftOffsetInPixel\":85,\"topOffsetInPixel\":222,\"widthInPixel\":240,\"heightInPixel\":14},\"confidence\":99.77},{\"word\":\"新闻联励志勤学刻苦磨炼促进青年成长进步\",\"location\":{\"leftOffsetInPixel\":36,\"topOffsetInPixel\":236,\"widthInPixel\":289,\"heightInPixel\":15},\"confidence\":98.64}]",
                      "type":"CHARACTER"
                  },
                  {
                      "data":"[{\"type\":\"figure\",\"result\":[{\"attribute\":\"郭志坚\",\"confidence\":93.01,\"source\":\"private_face\",\"location\":[{\"leftOffsetInPixel\":174,\"topOffsetInPixel\":61,\"widthInPixel\":64,\"heightInPixel\":60,\"degree\":2}]},{\"attribute\":\"郭志坚\",\"confidence\":68.24,\"source\":\"face_recognition\",\"location\":[{\"leftOffsetInPixel\":174,\"topOffsetInPixel\":61,\"widthInPixel\":64,\"heightInPixel\":60,\"degree\":2}]}]},{\"type\":\"keyword\",\"result\":[{\"attribute\":\"习近平\",\"confidence\":100.0,\"source\":\"character\"},{\"attribute\":\"中国政法大学\",\"confidence\":81.61,\"source\":\"character\"},{\"attribute\":\"树人\",\"confidence\":41.15,\"source\":\"character\"},{\"attribute\":\"cctv13\",\"confidence\":40.67,\"source\":\"character\"},{\"attribute\":\"新闻联\",\"confidence\":19.57,\"source\":\"character\"}]},{\"type\":\"logo\",\"result\":[{\"attribute\":\"cctv\",\"confidence\":90.63,\"source\":\"private_logo\",\"location\":[{\"leftOffsetInPixel\":22,\"topOffsetInPixel\":19,\"widthInPixel\":44,\"heightInPixel\":17}]},{\"attribute\":\"中央电视台\",\"confidence\":86.54,\"source\":\"logo\",\"location\":[{\"leftOffsetInPixel\":22,\"topOffsetInPixel\":19,\"widthInPixel\":44,\"heightInPixel\":17}]}]},{\"type\":\"entity\",\"result\":[{\"attribute\":\"郭志坚\",\"confidence\":80.34,\"source\":\"object_detect\"},{\"attribute\":\"人物-新闻主播\",\"confidence\":79.0,\"source\":\"image_classify\"},{\"attribute\":\"人物特写\",\"confidence\":65.75,\"source\":\"object_detect\"},{\"attribute\":\"超级星光大道\",\"confidence\":46.16,\"source\":\"object_detect\"},{\"attribute\":\"电视屏幕\",\"confidence\":27.78,\"source\":\"object_detect\"},{\"attribute\":\"发布会\",\"confidence\":6.73,\"source\":\"object_detect\"}]}]",
                      "type":"TAG"
                  }
              ],
              "source":"http://domain.com/dir/image.jpg",
              "status":"FINISHED",
              "title":""
          }

          分析失败时返回:

          {
              "error": {
                  "code": "InternalError",
                  "message": "subtask image_classify internal error, please retry"
              },
              "preset": "default",
              "source": "http://domain.com/dir/image.jpg",
              "status": "ERROR",
              "title": ""
          }
          上一篇
          直播分析接口
          下一篇
          通知接口