API文档 - AIDOG - 立志做全世界最聪明的狗

图片智能裁剪

文档中心/ImageCut API

版本：3.1.2

描述：传入图片和宽高进行裁剪。

更新日志：2017 年 11 月 21 日:3.1.2 版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=1

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	ratios	JSON	[{"wratio":"16","hratio":"9","width":"550"},{"wratio":"4","hratio":"3","width":"400"}] 其中wratio/hratio表示裁剪比例的宽高比，width表示图片宽度
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 异步请求任务 ID imgresult: 裁剪结果在服务器上的存放路径

返回值示例

请求成功返回示例
{ "success": true, "resultCode": null, "processMsg": null, "data": { "taskId": null, "dir": "", "imgresult": { "16_9_300": [ "/data/imgdata/imgthumb/20171121/aaap-YoGrAAB7ewlBGz_v/07ec6ea44f04a076b7807403f059a99d_2_16_9_300.jpg" ] }, "imgsrc": [ "07ec6ea44f04a076b7807403f059a99d_2.bmp" ], "paramError": [ ] }, "code": 0 }
{ "code": 100, "message": "错误信息" }

请求成功返回示例

{
  "success": true,
  "resultCode": null,
  "processMsg": null,
  "data": {
    "taskId": null,
    "dir": "",
    "imgresult": {
      "16_9_300": [
        "/data/imgdata/imgthumb/20171121/aaap-YoGrAAB7ewlBGz_v/07ec6ea44f04a076b7807403f059a99d_2_16_9_300.jpg"
      ]
    },
    "imgsrc": [
      "07ec6ea44f04a076b7807403f059a99d_2.bmp"
    ],
    "paramError": [ ]
  },
  "code": 0
}

请求失败返回示例


{
  "code": 100,
  "message": "错误信息"
}

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=1" \
-F "img=@/home/szh/Pictures/1.jpg" \
-F "ratio=[{"wratio":"16","hratio":"9","width":"550"}]" \
-F "token=xxxx"

图片鉴黄

文档中心/EroticDetection API

版本：4.1.3

描述：识别图片中是否包含色情内容。

更新日志：2017 年 11 月 21 日:4.1.3 版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=2

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 任务 ID result:包含每张图片识别结果数据 naiList : 非法图片列表

result中包含的元素说明

字段	类型	说明
rate	double	值在0~1之间的浮点数，值越大黄图的概率越大
name	String	图片名称
review	boolean	是否需要人工审核
etype	int	0-正常；1-性感；2-黄图；3-需人工审核

返回值示例

请求成功返回示例
{ "success": true, "data": { "taskId": "d49a401da5db638fe729096f3be0ffaf", "result": [ { "rate": 0.99999726, "name": "l.jpg", "review": false, "etype": 2 }, { "rate": 0.39999726, "name": "2.jpg", "review": false, "etype": 0 } ], "naiList": [ ], "eroticNum": 1, "reviewNum": 0 }, "code": 0 }
{ "code": 100, "message": "错误信息" }

请求成功返回示例

{
  "success": true,
  "data": {
    "taskId": "d49a401da5db638fe729096f3be0ffaf",
    "result": [
      {
        "rate": 0.99999726,
        "name": "l.jpg",
        "review": false,
        "etype": 2
      },
      {
        "rate": 0.39999726,
        "name": "2.jpg",
        "review": false,
        "etype": 0
      }
    ],
    "naiList": [ ],
    "eroticNum": 1,
    "reviewNum": 0
  },
  "code": 0
}

请求失败返回示例

{
  "code": 100,
  "message": "错误信息"
}

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=2" \
-F "img=@/home/szh/Pictures/1.jpg" \
-F "token=xxxx"

物体识别

文档中心/ObjectDetection API

版本：2.3.3

描述：识别图片中的物体。

更新日志：2017 年 11 月 21 日:2.3.3 版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=3

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 任务 ID objects:识别结果,支持一张图片中存在多个物体,score 为可信度(取值在 0~1 之间的浮点数,值越大越可信) naiList : 非法图片列表

返回值示例

请求成功返回示例
{ "success": true, "data": { "taskId": "d49a401da5db638fe729096f3be0ffaf", "objects": { "a3e28d3a12f5a56aa2821b08d6282dcb_timg.jpg": [ { "name": "person", "label": "person", "x": 59, "y": 105, "width": 188, "height": 607, "score": 0.5977487 }, { "name": "necktie", "label": "necktie", "x": 239, "y": 72, "width": 311, "height": 640, "score": 0.33858714 } ] }, "naiList": [ ] }, "code": 0 }
{ "code": 100, "message": "错误信息" }

请求成功返回示例

{
  "success": true,
  "data": {
    "taskId": "d49a401da5db638fe729096f3be0ffaf",
    "objects": {
      "a3e28d3a12f5a56aa2821b08d6282dcb_timg.jpg": [
        {
          "name": "person",
          "label": "person",
          "x": 59,
          "y": 105,
          "width": 188,
          "height": 607,
          "score": 0.5977487
        },
        {
          "name": "necktie",
          "label": "necktie",
          "x": 239,
          "y": 72,
          "width": 311,
          "height": 640,
          "score": 0.33858714
        }
      ]
    },
    "naiList": [ ]
  },
  "code": 0
}

请求失败返回示例

{
  "code": 100,
  "message": "错误信息"
}

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=3" \
-F "img=@/home/szh/Pictures/2.bmp" \
-F "token=xxxx"

人脸检测定位

文档中心/FaceDetection API

版本：1.0

描述：识别图片中的物体。

更新日志：2017 年 12 月 5 日：1.0版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=4

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 任务 ID result: 检测结果 naiList : 非法图片列表

result 中包含的元素说明

字段	类型	说明
imgName	Stringn	图片名称
success	boolean	处理状态
faces	Json	包含属性: rect: 人脸框，包含左上角坐标(x,y)、宽度width以及高度height landmarks: 人脸关键点坐标

返回值示例

请求成功返回示例
{ "success":true, "resultCode":null, "processMsg":null, "data": { "taskId":"9f8612d0a1fcb8c836f1675acf244f01", "result": [ { "imgName":"88693366785386eed4bcecf39b45dd7a_2.bmp", "success":true, "faces": [ { "rect": {"x":320,"y":94,"width":190,"height":231}, "landmarks": [343,197,412,161,365,233,382,286,436,263] } ] } ], "naiList":[], "paramError":[] }, "code": 0 }
{ "code": 100, "message": "错误信息" }

请求成功返回示例

	{
	  "success":true,
	  "resultCode":null,
	  "processMsg":null,
	  "data":
	  {
		"taskId":"9f8612d0a1fcb8c836f1675acf244f01",
		"result":
		  [
			{
			  "imgName":"88693366785386eed4bcecf39b45dd7a_2.bmp",
			  "success":true,
			  "faces":
			  [
				{  "rect":
				      {"x":320,"y":94,"width":190,"height":231},
				   "landmarks":
					  [343,197,412,161,365,233,382,286,436,263]
				}
			  ]
			}
		  ],
		"naiList":[],
		"paramError":[]
	  },
	  "code": 0
	}

请求失败返回示例


	{
	  "code": 100,
	  "message": "错误信息"
	}

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=4" \
-F "img=@/home/szh/Pictures/2.bmp" \
-F "token=xxxx"

政治人物识别

文档中心/PoliticianFaceRecognition API

版本：4.5.3

描述：识别图片中的政治人物

更新日志：2017 年 11 月 21 日:4.5.3 版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=5

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 任务 ID politicians: 识别结果,支持一张图片中存在多个政治人物, 其中 similarity 为相似度,如果<=0 则表示系统暂时无法识别 naiList : 非法图片列表

返回值示例

请求成功返回示例
{ "success": true, "data": { "taskId": "d49a401da5db638fe729096f3be0ffaf", "politicians": { "1116685034_14432288361951n.jpg": [ { "name": "Xi Jinping", "chName": "习近平", "x": 243, "y": 114, "width": 81, "height": 108, "similarity": 0.6999257767956784 }, { "name": "Obama", "chName": "奥巴马", "x": 583, "y": 124, "width": 82, "height": 98, "similarity": 0.6257462154415125 } ] }, "naiList": [ ] }, "code": 0 }
{ "code": 100, "message": "错误信息" }

请求成功返回示例

{
  "success": true,
  "data": {
    "taskId": "d49a401da5db638fe729096f3be0ffaf",
    "politicians": {
      "1116685034_14432288361951n.jpg": [
        {
          "name": "Xi Jinping",
          "chName": "习近平",
          "x": 243,
          "y": 114,
          "width": 81,
          "height": 108,
          "similarity": 0.6999257767956784
        },
        {
          "name": "Obama",
          "chName": "奥巴马",
          "x": 583,
          "y": 124,
          "width": 82,
          "height": 98,
          "similarity": 0.6257462154415125
        }
      ]
    },
    "naiList": [ ]
  },
  "code": 0
}

请求失败返回示例

{
  "code": 100,
  "message": "错误信息"
}

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=5" \
-F "img=@/home/szh/Pictures/1.jpg" \
-F "token=xxxx"

文字识别

文档中心/CharacterRecognition API

版本：1.0.0

描述：识别图片中的文字

更新日志：2018 年 03 月 27 日:1.0.0 版本。

图片要求：

图片格式：JPG(JPEG)，PNG
图片像素尺寸：最小 96*96 像素，最大 4096*4096 像素
图片文件大小：2 MB

调用 URL：http://api.aidog.com/aidog/identify?productId=6

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	img或img[]	String	文件上传表单元素名称，支持多文件
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
success	boolean	success: 成功上传并接收请求 false: 拒绝接收请求或上传失败
data	Json	包含属性: taskId: 任务 ID naiList :非法图片列表 text:识别结果,key-value 形式，key 为图片名称，value 为识别出来的文字

返回值示例

请求成功返回示例
{ "success": true, "resultCode": null, "processMsg": null, "data": { "taskId":"d49a401da5db638fe729096f3be0ffaf", "text": { "1.jpg": " " }, "naiList": [] } }
请求失败返回示例
{ "code": 100, "message": "错误信息" }

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=6" \
-F "img=@/home/szh/Pictures/1.jpg" \
-F "token=xxxx"

敬请期待...

维权中心

文档中心/RightsCenter API

版本：3.6.3

描述：检查文章是否为侵权

更新日志：2017 年 11 月 21 日:3.6.3 版本。

调用 URL（基于关键词的局部敏感快速检索获）：http://api.aidog.com/aidog/identify?productId=10

调用 URL（基于SimHash的局部敏感快速检索）：http://api.aidog.com/aidog/identify?productId=11

调用方法：POST

请求参数

是否必选	参数名	类型	参数说明
必选	title	string	文章标题
必选	context	string	文章内容
必选	token	String	购买生成的token

返回值说明

字段	类型	说明
data	array	data: 识别结果
limit	array	识别结果,示例文章url，不是全部

返回值示例

请求成功返回示例
{ "data": [ "171129083021567", "171129145157773" ], "limit": [ "https://mini.eastday.com/mobile/171129083021567.html", "https://mini.eastday.com/mobile/171129145157773.html" ] }

调用示例

curl -X POST "http://api.aidog.com/aidog/identify?productId=10" \
-F "title=搞笑&context=搞笑的意义在于" \
-F "token=xxxx"
或
curl -X POST "http://api.aidog.com/aidog/identify?productId=11" \
-F "title=搞笑&context=搞笑的意义在于" \
-F "token=xxxx"