AI 助理
文档备案控制台
官方文档
首页

商品属性匹配

更新时间：
复制 MD 格式
我的收藏

基于多模态大模型的跨平台类目 + 必填属性一站式智能填写。输入货源平台商品信息（可输入商品图片， 最多 3 张 ），同时返回目标平台精准类目路径和该类目下所有必填属性的填写值，每个属性带置信度与填写理由。当前仅支持铺货平台 TEMU。同步调用。

定位与适用场景

TEMU 等平台对每个叶子类目都规定了一组必填属性（材质、电池属性、连接性、尺码、外壳材料、支持系统……），属性之间还存在层级关联（如"电池属性=可充电电池"才需要填"可充电电池型号"）。人工填写极易出错且耗时。

和商品类目匹配的区别：本接口在匹配到类目的同时，把该类目下的所有必填属性也自动填好，并支持多模态（结合图片）做更精准的属性推断。

典型场景：

  • 头部卖家批量铺货自动化：单次调用拿到全套属性，直接对接发布接口。

  • ERP / SaaS 集成：作为铺货流水线核心节点，替代人工属性填写。

  • SMB 快速上架：商家逐件上传商品信息与图片，几秒拿到完整发布草稿。

接口

POST /rest/ai/category/attribute/match

快速开始

import json

data = json.dumps({
    "SourcePlatform": "1688",
    "TargetPlatform": "temu",
    "Title": "现货适用宠物Airtag猫咪项圈防丢失可定位追踪小猫反光铃铛",
    "SourceCategory": "追踪器",
    "Description": "蓝色编织尼龙项圈，内置 AirTag 兼容定位模块...",
    "Sku": "紫色",
    "ItemSpec": "材质:涤纶,适用对象:通用,品牌:艾马逊AMASON PET",
    "ImageUrl": [
        "https://cbu01.alicdn.com/.../main.jpg",
        "https://cbu01.alicdn.com/.../detail-1.jpg"
    ]
})
result = make_signed_request("/rest/ai/category/attribute/match", data)

d = result["Data"]
print(f"类目: {d['CategoryPath']}")
for attr in d["Attributes"]:
    print(f"  {attr['Name']} ({attr['NameEn']}): {attr['SelectedValues']}  [置信度 {attr['Confidence']}]")

请求参数

参数

类型

必填

说明

SourcePlatform

String

是

货源平台，如 1688。

TargetPlatform

String

是

铺货平台。当前仅支持 temu。

Title

String

是

商品标题。模型主要语义信号来源。

SourceCategory

String

是

商品在货源平台的原始类目。用于辅助消歧。

Description

String

ImageUrl / Description 二选一

商品详情文本和商品详情图至少要填写其中一项，填写信息越多匹配越准确。

Sku

String

是

商品 SKU 标题，多 SKU 用分号分隔。

ItemSpec

String

是

商品属性键值对，如 "材质:涤纶,适用对象:通用,品牌:艾马逊AMASON PET"。

ImageUrl

String[]

ImageUrl / Description 二选一

商品图片 url 合集，最多 3 张 。与 Description 二选一必填。模型会提取画面内文本信息，需要传入的图片有文字信息，强烈建议传入主图 + 详情图。

响应字段

顶层结构

字段

类型

说明

Code

String

业务状态码。成功为 Success。

Message

String

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

Success

Boolean

本次调用是否成功。

RequestId

String

请求唯一标识。

Data.CategoryId

Number

命中叶子类目 ID。

Data.CategoryPath

String

完整类目路径，/ 分隔。

Data.CategoryName

String

叶子类目名称。

Data.TotalAttributes

Number

该类目下属性总数。

Data.FilledCount

Number

已成功填充的属性数量。

Data.Attributes

Object[]

属性填写结果数组，每个元素结构见下表。

Data.UsageMap.ProcessingCount

Number

本次处理次数，用于计费。

Attributes 数组元素

字段

类型

说明

Name

String

属性中文名（如"电池属性""支持系统""激光产品"）。

NameEn

String

属性英文名。

AttrId

Number

属性 ID（铺货平台口径）。

InputType

String

填写类型，如 单选下拉 / 多选勾选(最多3个) / 文本输入 等。

Matched

Boolean

是否成功匹配，true / false。false 时通常需要人工补填。

SelectedValues

String[]

已选值文本列表，如 ["iOS","Android"]。

SelectedVids

Number[]

已选值 ID 列表，如 [30127,30128]。

Confidence

Number

该属性填写的置信度，0-100。同 商品类目匹配 一致的三档分流建议。

Reason

String

匹配理由（自然语言），用于追溯和调优。

完整示例

请求示例

{
  "SourcePlatform": "1688",
  "TargetPlatform": "temu",
  "Title": "现货适用宠物Airtag猫咪项圈防丢失可定位追踪小猫反光铃铛",
  "SourceCategory": "追踪器",
  "Description": "蓝色编织尼龙项圈，内置 AirTag 兼容定位模块，含反光条与铃铛...",
  "Sku": "紫色",
  "ItemSpec": "材质:涤纶,适用对象:通用,品牌:艾马逊AMASON PET,图案:单色,是否专利货源:是",
  "ImageUrl": [
    "https://cbu01.alicdn.com/img/ibank/main.jpg",
    "https://cbu01.alicdn.com/img/ibank/detail-1.jpg"
  ]
}

响应示例（节选） 

{
  "Code": "success",
  "Message": "Success",
  "Success": true,
  "RequestId": "2157065A-D6C8-1F3E-A4D0-B1234567890",
  "Data": {
    "CategoryId": 1516,
    "CategoryPath": "宠物用品/猫用品/猫挂饰、项圈、牵引带/猫项圈",
    "CategoryName": "猫项圈",
    "TotalAttributes": 5,
    "FilledCount": 4,
    "Attributes": [
      {
        "Name": "支持系统", "NameEn": "Support System", "AttrId": 719265,
        "InputType": "多选勾选(最多3个)", "Matched": true,
        "SelectedValues": ["iOS", "Android"], "SelectedVids": [30127, 30128],
        "Confidence": 95,
        "Reason": "商品注明 AirTag 兼容款；智能定位设备通常双系统兼容"
      },
      {
        "Name": "电池属性", "NameEn": "Battery Properties", "AttrId": 662274,
        "InputType": "单选下拉", "Matched": true,
        "SelectedValues": ["可充电电池"], "SelectedVids": [52029],
        "Confidence": 90,
        "Reason": "商品支持蓝牙/智能定位且带电子设备，通常需可充电电池供电"
      },
      {
        "Name": "激光产品", "NameEn": "Laser Type", "AttrId": 682439,
        "InputType": "单选下拉", "Matched": true,
        "SelectedValues": ["不含激光功能"], "SelectedVids": [52255],
        "Confidence": 95,
        "Reason": "商品详情及属性中未提及任何激光相关功能或部件"
      }
    ],
    "UsageMap": { "ProcessingCount": 1 }
  }
}

使用建议

  • 必传图片：相比纯文本，传入 2-5 张图片能让"材质 / 颜色 / 外壳类型"等视觉强相关属性的置信度普遍提升 10-15 分。

  • matched=false 的兜底：当某必填属性 matched=false 或 confidence<60 时，应该把这条属性推到人工补填队列，不要直接发布。

  • breadcrumb 关联属性：依赖型属性（如"电池属性=可充电电池"→"可充电电池型号"）即使父属性已匹配，子属性也可能因信息不足而 matched=false，需要客户端做联动校验。

  • selectedVids vs selectedValues：直接对接 TEMU 发布接口时使用 selectedVids（数字 ID），人工审核 UI 上展示用 selectedValues（文本）。

  • 与单独的类目匹配的取舍：如果只需类目不需要属性，用商品类目匹配更快且费率更低。

错误码

错误码

触发场景

InvalidParameter

必填字段缺失 / TargetPlatform 不是 temu / ImageUrl 数组超过 3 张。

InputContentBlocked

输入文本或图片触发安全审核。

DownstreamUnavailable

下游多模态 LLM 服务暂时不可用。建议指数退避后重试。

FreeQuotaExhausted

试用额度已耗尽。

InternalError

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

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

使用限制

  • 调用模式：同步。默认 QPS = 2，单次请求超时上限 30 秒；详见频率限制。

  • 铺货平台：当前仅支持 TEMU。

  • 图片数量：ImageUrl 最多 3 张；支持 JPG/JPEG/PNG/BMP/WEBP，分辨率 256×256 至 3000×3000，单张 ≤ 10 MB。

  • 计费：¥0.035/次，按 ProcessingCount 计次。详见素材优化计费。

常见问题

当前是否只支持货源平台 1688、铺货平台 TEMU？

货源平台参数要求输入 1688，但对实际货源平台并不限制，仅需用户把商品基础信息（商品标题、商品类目、商品属性、商品详情）输入即可。铺货平台目前仅支持 TEMU，后续会拓展更多平台。

如果只有商品链接、没有各类基础信息，能否直接提取商品信息并完成属性匹配？

目前暂不支持依据货源平台商品链接直接提取商品信息，后续迭代会支持。

什么情况下需要输入商品图片？要输入哪些图片？

当货源平台商品缺少较详细的商品属性和详情时，建议输入商品图片（图片中需包含文字），系统会利用 OCR 提取并补充商品基础信息，作为类目属性判断依据，从而生成更准确的类目与属性。

后续步骤

上一篇：商品类目匹配下一篇：智能抠图