尺码图检测
检测输入图片是否为尺码表,返回布尔结果。基于视觉分类模型,支持自定义置信度阈值。适合在批量素材流水线里作为"尺码图提取"的前置过滤,降低无效计费。同步调用。
定位与适用场景
本接口是一个轻量分类器,只回答"这张图是不是尺码表"。和尺码图提取相比:本接口快、便宜,但不解析内容;提取接口慢、贵,但产出结构化数据。
典型用法:
-
批量素材入库:1688 商品详情图通常 8-20 张,其中尺码表只 1-2 张。先用本接口扫一遍,挑出尺码图,再走尺码图提取。
-
合规校验:服饰类目要求主图不能含尺码表(应放详情图)。批量主图过一遍
IsSizeChart=true的就报警。 -
素材分类标签:给海量商品图加
size-chart标签,便于客户端做条件渲染。
接口
POST /rest/ai/sizeChart/detect
快速开始
典型用法是批量过滤:对一批商品图逐张调用检测接口,挑出尺码图,再统一送尺码图提取,避免对非尺码图付费。
import json
# 一批商品详情图(1688 商品通常 8-20 张,尺码图仅 1-2 张)
image_urls = [
"https://example.com/detail-1.jpg",
"https://example.com/detail-2.jpg",
"https://example.com/detail-3.jpg",
]
size_chart_urls = []
for url in image_urls:
data = json.dumps({"ImageUrl": url, "Threshold": "0.4"})
res = make_signed_request("/rest/ai/sizeChart/detect", data)
# 同步返回:Data.IsSizeChart 为布尔结果
if res["Data"]["IsSizeChart"]:
size_chart_urls.append(url)
print("识别到的尺码图:", size_chart_urls)
# 后续把 size_chart_urls 批量送「尺码图提取」接口做结构化解析
请求参数
|
参数 |
类型 |
必填 |
说明 |
|
|
String |
是 |
图片 URL。要求:JPG / JPEG / PNG / BMP / WEBP 格式;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。 |
|
|
String |
否 |
判定阈值,取值 0.0 - 1.0,默认 |
响应字段
|
字段 |
类型 |
说明 |
|
|
String |
业务状态码。成功为 |
|
|
String |
报错信息。成功时为 |
|
|
Boolean |
本次调用是否成功。 |
|
|
String |
请求唯一标识。 |
|
|
Boolean |
是否为尺码表图片: |
|
|
Number |
本次已处理图片张数,用于计费核对。 |
完整示例
请求示例
{
"ImageUrl": "https://img.alicdn.com/imgextra/i4/example.jpg",
"Threshold": "0.4"
}
响应示例
{
"Code": "success",
"Message": "Success",
"Success": true,
"RequestId": "8b6ccc4c-9289-9a9e-bf1e-08aa88895505",
"Data": {
"IsSizeChart": false,
"UsageMap": { "ProcessedImageCount": 1 }
}
}
使用建议
-
典型阈值选择:默认 0.4 适用大多数服饰场景;如果是首饰 / 鞋包等"尺码表样式更非典型"的类目,建议先用 0.3 提高召回,再人工抽检。
-
提取流水线最佳实践:客户端先并发调本接口(QPS=5),过滤出
IsSizeChart=true的图,再异步提交尺码图提取。整体成本通常降低 60-80%。 -
对比 Detection vs Extraction 的计费:本接口按
ProcessedImageCount计件,但费率显著低于提取接口(详见计费页)。
错误码
|
错误码 |
触发场景 |
|
|
|
|
|
输入图片触发内容安全审核。 |
|
|
图片下载失败 / 下游分类模型不可用。建议指数退避后重试。 |
|
|
试用额度已耗尽。 |
|
|
服务端内部错误。请保留 |
完整错误码列表参见错误码。
使用限制
-
调用模式:同步。默认 QPS = 5,单次请求超时上限 30 秒。
-
输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。单接口仅支持单图。
-
计费:¥0.01/张,按
ProcessedImageCount计件。详见素材优化计费。
常见问题
后续步骤
-
尺码图提取 -- 检测命中后的下一步:把尺码表结构化输出。
-
商品素材优化 Pro -- 服饰类目 Pro 工作流会自动串联 检测 → 提取 → 写属性。