尺码图检测

更新时间:
复制 MD 格式

检测输入图片是否为尺码表,返回布尔结果。基于视觉分类模型,支持自定义置信度阈值。适合在批量素材流水线里作为"尺码图提取"的前置过滤,降低无效计费。同步调用。

定位与适用场景

本接口是一个轻量分类器,只回答"这张图是不是尺码表"。和尺码图提取相比:本接口快、便宜,但不解析内容;提取接口慢、贵,但产出结构化数据。

典型用法:

  • 批量素材入库: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 批量送「尺码图提取」接口做结构化解析

请求参数

参数

类型

必填

说明

ImageUrl

String

图片 URL。要求:JPG / JPEG / PNG / BMP / WEBP 格式;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。

Threshold

String

判定阈值,取值 0.0 - 1.0,默认 0.4越低判定越宽松(更多图被判为尺码表,召回高但精度低);越高越严格(精度高但召回低)。0 = 全部判 true;1 = 全部判 false。

响应字段

字段

类型

说明

Code

String

业务状态码。成功为 Success

Message

String

报错信息。成功时为 "ok"

Success

Boolean

本次调用是否成功。

RequestId

String

请求唯一标识。

Data.IsSizeChart

Boolean

是否为尺码表图片:true / false

Data.UsageMap.ProcessedImageCount

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 计件,但费率显著低于提取接口(详见计费页)。

错误码

错误码

触发场景

InvalidParameter

ImageUrl 不可访问 / 格式不符 / Threshold 不是 0-1 的数值。

InputContentBlocked

输入图片触发内容安全审核。

DownstreamUnavailable

图片下载失败 / 下游分类模型不可用。建议指数退避后重试。

FreeQuotaExhausted

试用额度已耗尽。

InternalError

服务端内部错误。请保留 RequestId 联系技术支持。

完整错误码列表参见错误码

使用限制

  • 调用模式:同步。默认 QPS = 5,单次请求超时上限 30 秒。

  • 输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。单接口仅支持单图。

  • 计费¥0.01/张,按 ProcessedImageCount 计件。详见素材优化计费。

常见问题

尺码图检测能力是否支持批量?

本接口为单图处理模式(一次一张)。批量场景下逐张多次调用即可,可在客户端并发提交。

尺码图检测能力应该如何使用?

从批量图片中先检测出含尺码图的数据,再进一步做图片翻译或尺码图提取,可帮助商家减少不必要的处理成本。

后续步骤