Productai

通用标注服务

通用图片内容分析与标注服务可对用户上传的图片中客观与主观内容进行分析,并以文字标签的形式返回结果。所覆盖的内容范围包含图中场景、物体、人物、行为、情绪、图片拍摄手法等。

调用说明

Python

PHP

Java

C#

cURL

from productai import Client

cli = Client(ACCESS_KEY_ID, SECRET_KEY)

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

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

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

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

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

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);

// 获取对应的服务API,使用URL作为参数
ClassifyByImageUrlRequest request = new ClassifyByImageUrlRequest("classify", "_0000159");
request.setUrl("https://yyyy");

//或者使用本地文件作为参数调用API
ClassifyByImageFileRequest request = new ClassifyByImageFileRequest("classify", "_0000159");
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', "_0000159")
{
Url = "https://yyyy",
};

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

var response = client.GetResponse(request);
# 使用URL作为参数调用API
curl -X POST \
-H 'x-ca-version: 1.0' \
-H 'x-ca-accesskeyid: ACCESS_KEY_ID' \
-d 'url=http://xxx.jpg' \
https://api.productai.cn/classify/_0000159

# 或者使用本地文件作为参数调用API
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/_0000159

输入参数说明

参数名称类型说明必选限制
url字符串Query图片的链接,query方法第一个参数与search参数二选一
search文件Query图片文件内容,query方法第一个参数与url参数二选一
count整数返回标签个数默认为20

返回结果说明

200 HTTP状态码

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

{
"is_err": 0,
"request_id": "5e0c705c-e09f-11e7-91d5-72f17f92a514",
"results": [
{
"category": "室内",
"puid": "indoor",
"score": 0.9736321524042493
},
{
"category": "食物",
"puid": "food",
"score": 0.9712933092798621
},
{
"category": "半身像",
"puid": "half-length photo",
"score": 0.9630682046079396
},
{
"category": "近景",
"puid": "close shot",
"score": 0.9563565643119167
},
{
"category": "平视角",
"puid": "flat view",
"score": 0.9489112115335308
}
],
"time": 0.3276219367980957
}
结果字段类型说明
is_err整数1表示有错误,0表示没有错误
request_id字符串本次请求的唯一识别ID,用于和ProductAI平台进行联调诊断
results数组该图片有可能的所有标签集合
category字符串当前语言设置下的,标签文本
puid字符串当前标签类别的唯一ID
score浮点数当前标签类别的可能概率
time浮点数服务器端计算时间,单位为秒

错误信息说明

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

http状态码error_code说明
200N/aAPI调用成功
400N/a未上传Query图片URL

标签列表

点击此处下载标签列表。如需切换不同语言的标签,请参考多语言支持