该接口通过大语言模型实现货源平台到铺货平台的商品类目智能匹配，返回最优类目路径、ID、置信度及理由，解决跨平台铺货类目选择痛点。-电商经营助手-阿里云帮助中心

定位与适用场景

跨平台铺货的第一痛点是类目选择：货源平台（1688）的类目体系和铺货平台（TEMU）完全不同，人工对应需要熟悉目标平台的几万个叶子类目，耗时且错误率高，错配类目直接影响曝光与流量。

本接口把这一步自动化，适用于：

头部卖家自建系统：批量调用 API 写入 ERP，自动完成类目映射。
ERP / SaaS 平台集成：作为自动化铺货流程中的一环。
SMB 单品快速上架：商家逐件提交，几秒拿到类目建议。

如果还需要同时填写类目下的必填属性（如颜色、材质），使用商品属性匹配。

接口

POST /rest/ai/category/match

请求参数

参数	类型	必填	说明
`SourcePlatform`	String	是	货源平台，如 `1688`。
`TargetPlatform`	String	是	铺货平台。当前仅支持 `temu`，后续将扩展更多平台。
`Title`	String	是	商品标题。模型主要语义信号来源。
`SourceCategory`	String	是	商品在货源平台的原始类目。用于辅助消歧。
`Description`	String	是	商品详情 / 详细描述。越完整匹配越准。可包含材质、用途、规格等。
`Sku`	String	否	商品 SKU 标题。如 `"0:0:颜色:黑;0:1:颜色:蓝;..."`，帮助模型理解多规格场景。
`ItemSpec`	String	否	商品属性键值对，如 `"材质:涤纶,适用对象:通用,品牌:艾马逊"`。能显著提升精确类目命中率。

响应字段

字段	类型	说明
`Code`	String	业务状态码。成功为 `Success`。
`Message`	String	报错信息。成功时为 `"ok"`。
`Success`	Boolean	本次调用是否成功。
`RequestId`	String	请求唯一标识。
`Data.MatchSuccessful`	Boolean	是否成功匹配到类目。`false` 时其他字段可能为空。
`Data.CategoryId`	String	命中的目标平台叶子类目 ID（可直接传给目标平台的发布接口）。
`Data.CategoryPath`	String	完整类目路径，以 `/` 分隔，如 `宠物用品/猫用品/猫挂饰、项圈、牵引带/位置和活动跟踪器`。
`Data.CategoryName`	String	叶子类目名称（`CategoryPath` 的最后一段）。
`Data.Confidence`	Number	置信度评分，0-100。一般 ≥ 85 可直接使用，70-85 建议人工二次确认，< 70 应回退到人工。
`Data.Reason`	String	匹配理由说明（自然语言），便于追溯和调优。
`Data.UsageMap.ProcessingCount`	Number	本次处理次数，用于计费。

完整示例

请求示例

{
  "SourcePlatform": "1688",
  "TargetPlatform": "temu",
  "Title": "现货适用宠物Airtag猫咪项圈防丢失可定位追踪小猫反光铃铛",
  "SourceCategory": "追踪器",
  "Description": "蓝色编织尼龙项圈，内置 AirTag 兼容定位模块，含反光条与铃铛。可调节扣带，适配不同体型。专利号 ZL 2022 3 0251055.5。",
  "ItemSpec": "材质:尼龙/硅胶,颜色:蓝色,适用对象:猫咪,是否可调节:是"
}

响应示例

{
  "Code": "success",
  "Message": "Success",
  "Success": true,
  "RequestId": "2157065A-D6C8-1F3E-A4D0-B1234567890",
  "Data": {
    "MatchSuccessful": true,
    "CategoryId": "1522",
    "CategoryPath": "宠物用品/猫用品/猫挂饰、项圈、牵引带/位置和活动跟踪器",
    "CategoryName": "位置和活动跟踪器",
    "Confidence": 96,
    "Reason": "商品核心为带 AirTag 定位功能的猫项圈，属'位置和活动跟踪器'类目，叶子节点语义精准匹配其追踪功能与猫用属性。",
    "UsageMap": { "ProcessingCount": 1 }
  }
}

使用建议

提升匹配率：尽可能传入 Description 和 ItemSpec。仅传标题时 Confidence 通常低 10-20 分。
置信度阈值策略：建议在客户端设置三档分流——≥85 自动接收、70-85 进人工审核队列、<70 回退人工。
多语言商品标题：模型支持中英文混合，但建议输入语言与 SourcePlatform 一致。如果源标题已是英文（如 1688 国际站），保持英文即可。
与属性匹配组合：批量上架时通常需要类目 + 必填属性都填齐。直接调商品属性匹配一次性返回两者，比分别调用更省成本。

错误码

错误码	触发场景
`InvalidParameter`	必填字段缺失 / `TargetPlatform` 不是 `temu`。
`InputContentBlocked`	输入内容触发安全审核。
`DownstreamUnavailable`	下游 LLM 服务暂时不可用。建议指数退避后重试。
`FreeQuotaExhausted`	试用额度已耗尽。
`InternalError`	服务端内部错误。请保留 `RequestId` 联系技术支持。

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

使用限制

调用模式：同步。默认 QPS = 2，单次请求超时上限 30 秒；详见频率限制。
铺货平台：当前仅支持 TEMU，后续将扩展更多。
计费：¥0.015/次，按 ProcessingCount 计次。详见素材优化计费。

后续步骤

商品属性匹配 -- 一次性返回类目 + 必填属性。
商品素材优化 Lite -- 自动串联类目匹配与素材处理。