Productai

分析与标注服务

对图片内容分析并给出相关文本信息。

调用说明

Python

PHP

Java

C#

cURL

from productai import Client

cli = Client(ACCESS_KEY_ID, SECRET_KEY)

# 获取对应的服务API
api = cli.get_api('classify', '_xxxxxxxx')

# 使用URL作为参数调用API
resp = api.query('https://yyyy')

# 或者使用本地文件作为参数调用API
with open("zzzz.jpg", mode='rb') as search:
resp = api.query(search)
use ProductAI;

// 获取对应的服务API
$product_ai = new ProductAI\API(ACCESS_KEY_ID, SECRET_KEY, 'zh-Hans');

// 使用URL作为参数调用API
$result = $product_ai->classifyImage('classify', '_xxxxxxxx', 'https://yyyy');

// 或者使用本地文件作为参数调用API
$result = $product_ai->classifyImage('classify', '_xxxxxxxx', '@zzzz.jpg');
import java.io.File;
import cn.productai.api.core.*;
import cn.productai.api.core.enums.*;
import cn.productai.api.pai.entity.classify.*;

// 设置API调用初始化参数
IProfile profile = new DefaultProfile();
profile.setAccessKeyId(ACCESS_KEY_ID);
profile.setSecretKey(SECRET_KEY);
profile.setVersion("1");
profile.setGlobalLanguage(LanguageType.Chinese);
IWebClient client = new DefaultProductAIClient(profile);

// 使用URL作为参数调用API
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_xxxxxxxx");
request.setUrl("https://yyyy");

// 或者使用本地文件作为参数调用API
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_xxxxxxxx");
request.setImageFile(new File(".//zzzz.jpg"));

ClassifyResponse response = client.getResponse(request);
String json = response.getResponseJsonString();
using MalongTech.ProductAI.Core;
using MalongTech.ProductAI.API.Entity;

IProfile profile = new DefaultProfile
{
Version = "1",
AccessKeyId = ACCESS_KEY_ID,
SecretKey = SECRET_KEY,
GlobalLanguage = LanguageType.Chinese
};
var client = new DefaultProductAIClient(profile);

// 使用URL作为参数调用API
var request = new ClassifyByImageUrlRequest('classify', '_xxxxxxxx')
{
Url = "https://yyyy",
};

// 或者使用本地文件作为参数调用API
var request = new ClassifyByImageFileRequest('classify', '_xxxxxxxx')
{
ImageFile = new System.IO.FileInfo(@"zzzz.jpg"),
};

var response = client.GetResponse(request);

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d "url=https://yyyy" \
https://api.productai.cn/classify/_xxxxxxxx

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-F "search=@zzzz.jpg" \
https://api.productai.cn/classify/_xxxxxxxx

其中’_xxxxxxxx’代表具体的classify服务ID, 请参考服务列表

输入参数说明

参数名称类型说明必选限制
url字符串Query图片的链接与search参数二选一
search文件Query图片文件内容与url参数二选一

返回结果说明

200 HTTP状态码

服务器端成功处理,并返回结果

{
"classify_time": "0.081",
"is_err": 0,
"request_id": "9c0745ea-dff9-11e7-914b-9e715a41c4bb",
"results": [
{
"category": "Non-porn",
"puid": "Non-porn",
"score": 0.999858
},
{
"category": "Porn",
"puid": "Porn",
"score": 0.000142
}
],
"version": "2.0.2"
}
结果字段类型说明
classify_time字符串API服务器端总的时间消耗,单位为秒
request_id字符串本次请求的唯一识别ID,用于和ProductAI平台进行联调诊断
results数组该图片有可能的所有标签集合
category字符串当前语言设置下的,标签文本
puid字符串当前标签类别的唯一ID
score浮点数当前标签类别的可能概率

非200 HTTP状态码

服务器端遇到错误

{
"data": {
"is_err": 1,
"msg": "Could not download http://a.com/b.jpg",
"request_id": "69d086c8-e142-11e7-bb18-eea500941bf4"
},
"status": 400
}
结果字段类型说明
data字典所有信息包装到data中
status整数 HTTP状态码
is_err整数 1表示有错误,0表示没有错误
message字符串错误信息详情
request_id字符串本次调用的唯一ID,可以用于和ProductAI团队进行联调分析

错误信息说明

SDK/API使用http状态码来通知客户端本次调用成功和失败

http状态码error_code说明
200N/aAPI调用成功
4032005该API服务未对客户开放
4041001API服务不存在

服务列表

场景分析与标注 v1.0

分析图片中的场景信息,并以文字标签的形式返回分析结果。如需要切换不同语言的标签,请参考多语言支持

Python

PHP

Java

C#

cURL

# _0000039为场景分析服务ID
api = cli.get_api('classify', '_0000039')
// _0000039为场景分析服务ID,使用URL调用服务
$result = $product_ai->classifyImage('classify', '_0000039', 'https://yyyy');

// _0000039为场景分析服务ID,使用本地文件调用服务
$result = $product_ai->classifyImage('classify', '_0000039', '@zzzz.jpg');
// _0000039为场景分析服务ID,使用URL调用服务
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_0000039");

// _0000039为场景分析服务ID,使用本地文件调用服务
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_0000039");
// _0000039为场景分析服务ID,使用URL调用服务
var request = new ClassifyByImageUrlRequest('classify', "_0000039")
{
Url = "https://yyyy",
};

// _0000039为场景分析服务ID,使用本地文件调用服务
var request = new ClassifyByImageFileRequest('classify', "_0000039")
{
ImageFile = new System.IO.FileInfo(@"zzzz.jpg"),
};

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d "url=https://yyyy" \
https://api.productai.cn/classify/_0000039

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-F "search=@zzzz.jpg" \
https://api.productai.cn/classify/_0000039

中/英文标签

点击此处下载标签列表。

色情分析与标注 v1.0

分析图片是否含有色情内容,并以文字标签的形式返回判断结果。

Python

PHP

Java

C#

cURL

# _0000024为色情分析服务ID
api = cli.get_api('classify', '_0000024')
// _0000024为色情分析服务ID,使用URL调用服务
$result = $product_ai->detectImage('classify', '_0000024', 'https://yyyy');

// _0000024为色情分析服务ID,使用本地文件调用服务
$result = $product_ai->detectImage('classify', '_0000024', '@zzzz.jpg');
// _0000024为色情分析服务ID,使用URL调用服务
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_0000024");

// _0000024为色情分析服务ID,使用本地文件调用服务
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_0000024");
// _0000024为色情分析服务ID,使用URL调用服务
var request = new ClassifyByImageUrlRequest('classify', "_0000024")
{
Url = "https://yyyy",
};

// _0000024为色情分析服务ID,使用本地文件调用服务
var request = new ClassifyByImageFileRequest('classify', "_0000024")
{
ImageFile = new System.IO.FileInfo(@"zzzz.jpg"),
};

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d "url=https://yyyy" \
https://api.productai.cn/classify/_0000024

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: eACCESS_KEY_ID' \
-F "search=@zzzz.jpg" \
https://api.productai.cn/classify/_0000024

中/英文标签列表

中文English
非色情Non-porn色情Porn

电商P图识别 v1.0

识别电商图片是否经过P图处理,返回质量好或质量差。
以下几种情况会返回质量差的结果:

  • 拼图:直接多张图片拼接在一起,有较为明显的边界
  • 加边框:在图片周边加边框
  • 牛皮癣:原图上面简单直接地加入文字
  • 分割:一张完整的图片切成若干个小图,较为常见的是九宫格、十六宫格
  • 水印:直接在商品图上加上水印,包括中文、英文、logo等
  • 海报:加上了logo、折扣、卖点等信息,相比牛皮癣有一定的设计

Python

PHP

Java

C#

cURL

# _0000197为电商P图服务ID
api = cli.get_api('classify', '_0000197')
// _0000197为电商P图服务ID,使用URL调用服务
$result = $product_ai->detectImage('classify', '_0000197', 'https://yyyy');

// _0000197为电商P图服务ID,使用本地文件调用服务
$result = $product_ai->detectImage('classify', '_0000197', '@zzzz.jpg');
// __0000197为电商P图服务ID,使用URL调用服务
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_0000197");

// _0000197为电商P图服务ID,使用本地文件调用服务
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_0000197");
// __0000197为电商P图服务ID,使用URL调用服务
var request = new ClassifyByImageUrlRequest('classify', "_0000197")
{
Url = "https://yyyy",
};

// _0000197为电商P图服务ID,使用本地文件调用服务
var request = new ClassifyByImageFileRequest('classify', "_0000197")
{
ImageFile = new System.IO.FileInfo(@"zzzz.jpg"),
};

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d "url=https://yyyy" \
https://api.productai.cn/classify/_0000197

curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: eACCESS_KEY_ID' \
-F "search=@zzzz.jpg" \
https://api.productai.cn/classify/_0000197

中/英文标签列表

中文English
质量好good质量差bad

室内场景分析与标注 v1.0

识别家居类图片中的室内场景,用于图像分析和标注。

Python

PHP

Java

C#

cURL

# _0000196为室内场景分析服务ID
api = cli.get_api('classify', '_0000196')
// _0000196为室内场景分析服务ID,使用URL调用服务
$result = $product_ai->detectImage('classify', '_0000196', 'https://yyyy');

// _0000196为室内场景分析服务ID,使用本地文件调用服务
$result = $product_ai->detectImage('classify', '_0000196', '@zzzz.jpg');
// _0000196为室内场景分析服务ID,使用URL调用服务
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_0000196");

// _0000196为室内场景分析服务ID,使用本地文件调用服务
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_0000196");
// _0000196为室内场景分析服务ID,使用URL调用服务
var request = new ClassifyByImageUrlRequest('classify', "_0000196")
{
Url = "https://yyyy",
};

// _0000196为室内场景分析服务ID,使用本地文件调用服务
var request = new ClassifyByImageFileRequest('classify', "_0000196")
{
ImageFile = new System.IO.FileInfo(@"zzzz.jpg"),
};
# 使用URL作为参数调用API
curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d "url=https://yyyy" \
https://api.productai.cn/classify/_0000196

# 或者使用本地文件作为参数调用API
curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: eACCESS_KEY_ID' \
-F "search=@zzzz.jpg" \
https://api.productai.cn/classify/_0000196

中/英文标签列表

中文English
餐厅dining_room茶室tea_room厨房kitchen儿童房childrens_bedroom
客厅living_room楼梯staircase露台patio书房study
庭院courtyard卫生间bathroom卧室bedroom玄关entrance
阳台balcony衣帽间walk_in_closet走廊hallway