尺码图提取(异步)

更新时间:
复制 MD 格式

1、产品简介

通过多模态大模型智能提取图片中的尺码图、件重尺等结构化信息。(异步)

2、适用场景

尺码图:提取服饰类目的尺码图成文本。

件重尺:提取图片中的件重尺信息。

3、功能介绍

尺码图提取服务基于多模态大模型,自动识别图片中的尺码表或件重尺信息,并将其转化为结构化文本输出。用户提供图片URL,系统以异步任务方式处理,返回提取后的结构化数据。支持通过ColumnNameList指定需识别的列名(如Size、Bust、Length等),实现精准定向提取;同时支持通过LanguageModel参数控制输出语言,可选中文(cn)或英文(en),不填则保留原始语言。适用于服饰类目尺码表文本化、商品件重尺信息批量结构化等场景。

核心能力:输入图片URL及可选的列名配置,输出图片中尺码表/件重尺的结构化数据。接口采用异步任务模式(background: true),提交后返回任务ID,需轮询获取最终结果,适合处理复杂图片或大批量调用场景。

4、效果对比

输入图

输出结果

image

{

"SizeChart": [

{

"尺码": {

"value": "S"

},

"腰围": {

"unit": "CM",

"value": 58

},

"裙长": {

"unit": "CM",

"value": 81

},

"体重建议": {

"unit": "kg",

"lower_value": 40,

"upper_value": 47.5

}

},

{

"尺码": {

"value": "M"

},

"腰围": {

"unit": "CM",

"value": 59

},

"裙长": {

"unit": "CM",

"value": 82

},

"体重建议": {

"unit": "kg",

"lower_value": 45,

"upper_value": 52.5

}

},

{

"尺码": {

"value": "L"

},

"腰围": {

"unit": "CM",

"value": 60

},

"裙长": {

"unit": "CM",

"value": 83

},

"体重建议": {

"unit": "kg",

"lower_value": 50,

"upper_value": 57.5

}

},

{

"尺码": {

"value": "XL"

},

"腰围": {

"unit": "CM",

"value": 61

},

"裙长": {

"unit": "CM",

"value": 84

},

"体重建议": {

"unit": "kg",

"lower_value": 55,

"upper_value": 62.5

}

},

{

"尺码": {

"value": "2XL"

},

"腰围": {

"unit": "CM",

"value": 62

},

"裙长": {

"unit": "CM",

"value": 85

},

"体重建议": {

"unit": "kg",

"lower_value": 60,

"upper_value": 67.5

}

}

],

"SizeChartAttributes": [

"尺码",

"裙长",

"腰围",

"体重建议"

],

"IntersectionAttributes": [

"尺码",

"裙长",

"腰围(拉伸)",

"体重建议"

]

}

5、开发指南

5.1 提交接口

5.1.1 请求参数

参数名称

类型

必填

参数描述及示例值

ImageUrl

String

是

图片 URL,图像需是JPG、JPEG、PNG、BMP、WEBP格式的,分辨率应在256×256至3000x3000像素之间,文件大小不超过10MB

示例值:"https://ae01.alicdn.com/kf/S342f0070dc9f4be09a6cbed34e90dc8fs.jpg"

ColumnNameList

String[]

否

需识别的列名,如Size、Bust、Length等

示例值:"list"

LanguageModel

String

否

输出语言格式,不填默认原版语言输出。若原图片语言为中文或者英文,输入en将输出英文,填cn将输出中文

示例值:"cn"

5.1.2请求示例

{
  "ImageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01KVnrhI1EzKDIqLh2p_!!2209511530422-0-cib.jpg",
  "ColumnNameList": null,
  "LanguageModel": cn
}

5.1.3 响应参数

参数名称

类型

参数描述

Code

String

状态码,如"success"

Success

Boolean

是否成功:true代表成功,false代表失败

RequestId

String

请求ID:用来识别唯一一次请求调用

Data

Object

返回的结果结构体信息

Data.TaskId

String

异步任务ID,用于后续查询任务结果

5.1.4 响应示例

{
  "Data": {
    "TaskId": "c657386a-f39e-9888-8570-1ca8b4603c19"
  },
  "RequestId": "233DC2E3-2554-1426-928E-67ECE0610EEE",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

5.2 查询接口

异步结果查询接口

5.2.1 请求参数

参数名称

类型

必填

参数描述及示例值

TaskId

string

是

请求后系统自动生成的TaskId

"d3929984-3acd-9f6a-ac25-dca0cdf06836"

5.2.2请求示例

{
  "TaskId": "c657386a-f39e-9888-8570-1ca8b4603c19"
}

5.2.3 响应参数

参数名

类型

描述

Code

String

状态码,如"success"

Success

Boolean

是否成功:true代表成功,false代表失败

RequestId

String

请求ID:用来识别唯一一次请求调用

Data

Object

返回的结果结构体信息

Data.TaskId

String

异步任务ID

Data.Status

String

任务状态,如"COMPLETED"

Data.Result

Object

任务执行结果

Data.Result.Message

Object

识别结果,key为输入图片URL

Data.Result.Message.{ImageUrl}

Object

单张图片的识别结果

Data.Result.Message.{ImageUrl}.SizeChart

Array<Object>

尺码表数据列表,字段根据识别结果动态返回(如Size、Weight、Length等)

Data.Result.Message.{ImageUrl}.SizeChart.{AttrName}.Unit

String

属性单位,如"CM"、"G"

Data.Result.Message.{ImageUrl}.SizeChart.{AttrName}.Value

String

属性值,如"321CM"、"10"

Data.Result.Message.{ImageUrl}.SizeChartAttributes

Array<String>

尺码表原始属性名列表

Data.Result.Message.{ImageUrl}.IntersectionAttributes

Array<String>

尺码表翻译后属性名列表(若翻译未生效与原始属性名列表一致)

Data.UsageMap

Object

用量字段

Data.UsageMap.ProcessedImageCount

Number

已处理图片数量

5.2.4 响应示例

{
  "Data": {
    "Status": "COMPLETED",
    "UsageMap": {
      "ProcessedImageCount": "1"
    },
    "TaskId": "c657386a-f39e-9888-8570-1ca8b4603c19",
    "Result": {
      "message": {
        "Https://cbu01.alicdn.com/img/ibank/o1cn01kvnrhi1ezkdiqlh2p!!2209511530422-0-cib.jpg": {
          "SizeChart": [
            {
              "尺码": {
                "value": "S"
              },
              "腰围": {
                "unit": "CM",
                "value": 58
              },
              "裙长": {
                "unit": "CM",
                "value": 81
              },
              "体重建议": {
                "unit": "kg",
                "lower_value": 40,
                "upper_value": 47.5
              }
            },
            {
              "尺码": {
                "value": "M"
              },
              "腰围": {
                "unit": "CM",
                "value": 59
              },
              "裙长": {
                "unit": "CM",
                "value": 82
              },
              "体重建议": {
                "unit": "kg",
                "lower_value": 45,
                "upper_value": 52.5
              }
            },
            {
              "尺码": {
                "value": "L"
              },
              "腰围": {
                "unit": "CM",
                "value": 60
              },
              "裙长": {
                "unit": "CM",
                "value": 83
              },
              "体重建议": {
                "unit": "kg",
                "lower_value": 50,
                "upper_value": 57.5
              }
            },
            {
              "尺码": {
                "value": "XL"
              },
              "腰围": {
                "unit": "CM",
                "value": 61
              },
              "裙长": {
                "unit": "CM",
                "value": 84
              },
              "体重建议": {
                "unit": "kg",
                "lower_value": 55,
                "upper_value": 62.5
              }
            },
            {
              "尺码": {
                "value": "2XL"
              },
              "腰围": {
                "unit": "CM",
                "value": 62
              },
              "裙长": {
                "unit": "CM",
                "value": 85
              },
              "体重建议": {
                "unit": "kg",
                "lower_value": 60,
                "upper_value": 67.5
              }
            }
          ],
          "SizeChartAttributes": [
            "尺码",
            "裙长",
            "腰围",
            "体重建议"
          ],
          "IntersectionAttributes": [
            "尺码",
            "裙长",
            "腰围(拉伸)",
            "体重建议"
          ]
        }
      }
    }
  },
  "RequestId": "A5E5AF2E-0728-1EE6-A5A7-5A941C2DF7A1",
  "Message": "Success",
  "Code": "success",
  "Success": true
}

5.5错误码

错误码

6、接入准备与调用流程

6.1前置说明

尺码图提取支持同步和异步两种调用方式。本文介绍异步调用接口,如需使用同步调用,请参阅尺码图提取。

尺码图提取及其他能力的异步接口共用结果获取流程、RocketMQ 订阅规则、消息加密协议、依赖配置,以及 Java 消费与解密代码。

异步调用的接入流程,订阅规则,消息格式与加密协议,以及详细的接入方案请参阅异步接口调用说明。

7、计费方式

¥0.03元/张

8、使用限制

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

输入图片:JPG / JPEG / PNG / BMP / WEBP;分辨率 256×256 至 3000×3000;文件 ≤ 10 MB。

计费:按 ProcessedImageCount 计件。详见 素材优化计费 。

9、常见问题

什么场景下可以用到尺码图提取能力?

当您经营的类目需要在平台上面提交尺码信息/获取尺码信息,而您只有原始商品素材的尺码图时候需要使用

相比直接使用ocr,本能力的优势在哪里?

①可由用户自主选择提取的列

②能够帮助用户过滤哪些图不需要进行尺码图提取,帮助用户节省不必要的成本