商品详情描述生成API调用说明

商品详情描述生成

GET/POST /ai/product/description/generation

产品描述

商品详情描述生成产品专为海外电商商品定制，通过简单入参，可生成内容丰富、卖点精准、充满吸引力的商品描述，解决商品详情文本信息缺失、重点不明确等信息效率低问题，提升商品转化率。

请求参数

参数	类型	必填	参数描述及示例值
productTitle	String	是	商品名称； 可以填商品品类名或者原始标题，总字符长度不超过 500。 示例值: "Pen for iPad, 13 mins Fast Charging Stylus with Palm Rejection, Tilt Sensitivity, Compatible with 2018-2022 iPad Air 3/4/5, iPad Mini 5/6, iPad 6/7/8/9/10, iPad Pro 11", iPad Pro 12.9" (Black)"
targetLanguage	String	是	标题生成的目标语言； 您可查看语言代码和支持生成标题的语向。 示例值: "es"
productCategory	String	是	商品所属类目； 您可参考任何平台的类目结构，或输入商品类目名称，类目信息越详细，生成结果会越精确。 示例值: ["Clothes"]
itemSpecs	String	否	商品属性，商品的特征描述，例如商品的材质等。输入商品属性名称和属性内容（键1: 值1, 键2: 值2），使生成效果更加详细准确。 示例值: "Number: 12 cans, Brand: Coca Cola"
productKeyWords	String[]	否	商品相关关键词，一般是商品SEO相关关键词或商品核心卖点词，输入信息越多，对生成结果帮助越大。填写需要在商品标题生成过程中额外添加的关键词内容。 示例值: "sweet"
productDescription	String	否	商品详细描述，阐述说明商品的卖点信息。在商品标题生成中，提供更多的基本信息，生成效果更加精准。 示例值: "Ergonomic Comfort Design: The wireless ergonomic keyboard features with curved and split key-frame design, which helps to position your wrist and forearm in a more natural, relaxed posture."

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/product/description/generation");
request.addApiParameter("targetLanguage", "en");
request.addApiParameter("productTitle", "Vintage Black Printing Blazer Women Jacket High Street Fashion 2024 Spring Plus Size Elegant Office Lady Coat American Stylish");
request.addApiParameter("productCategory", "Blazers");
request.addApiParameter("productKeyWords", "["female blazers jacket"]");
request.addApiParameter("itemSpecs", "[\"service:dropshippingClothing\", \"style\":Europe and America\",\"pattern:Printing\",\"season:spring\"]");
request.addApiParameter("productDescription", "Sleeve Type, style, Sleeve Length, distinctive features, category terms, benefits.");
IopResponse response = client.execute(request);
System.out.println(response.getBody());
Thread.sleep(10);

响应参数

参数	类型	描述
resCode	Number	响应代码； 200 代表调用成功，其他的响应代码可以参考错误码信息。
data	Object	生成的结果内容。
requestId	String	请求ID。
success	Boolean	请求成功。
resMessage	String	请求信息；如遇到报错，则会在此字段中体现。

响应示例

Java

{
  "data": {
    "usage": 1,
    "generatedDescription": [
      "Vintage Style:This blazer jacket features a vintage black printing design, perfect for those who love high street fashion and want to stand out in 2024 spring.",
      "Plus Size Availability:Catering to various body types, this jacket is available in plus sizes, ensuring everyone can enjoy its stylish design and comfortable fit.",
      "Elegant Office Lady Coat:This jacket is not just another piece of clothing, but an elegant office lady coat that adds a touch of sophistication to your daily outfit.",
      "High Quality Printing:The high-quality printing of the jacket ensures durability and longevity, maintaining its vibrant black color and distinctive design over time.",
      "Versatile High Street Fashion:As a versatile piece of high street fashion, this jacket can be paired with a variety of outfits, making it suitable for different occasions."
    ],
    "class": "com.aidc.service.api.client.text.dto.ProductDescGenerationResponse"
  },
  "requestId": "212c940e17192233277796296e0da7",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "212a664f17192233281552842",
  "_trace_id_": "212c940e17192233277796296e0da7"
}

错误码

错误码	错误信息	描述
501	rate limit exceed	当前接口已达到限流上限,请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们增加当前限制值。
700	invalid input	输入参数的格式不符合要求，resMessage 将返回详细的不符合要求的字段。
801	model failed	内部调用异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们进行故障排除。
1000	content has sensitive data, please try other input	内容包含敏感数据，请尝试其他输入。
1001	content control failed, please retry	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。
1002	content risk filter failed, please contact us	风控服务运行异常，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

附录

支持生成商品详情描述的语向

商品详情描述生成API支持以下表中列出的语言对之间的生成。我们会持续添加更多语言对。如您有具体需求，请搜索Aidge产品咨询&服务群钉钉群号：105455001046，入群联系我们。

源语言	目标语言
中文	英语
中文	西班牙语
中文	法语
中文	葡萄牙语
中文	韩语
中文	日语
中文	越南语
中文	泰语
中文	土耳其语
中文	印度尼西亚语
中文	德语
中文	意大利语
中文	马来语
中文	俄语
中文	荷兰语
英语	英语
英语	西班牙语
英语	法语
英语	葡萄牙语
英语	韩语
英语	日语
英语	越南语
英语	泰语
英语	土耳其语
英语	印尼语
英语	德语
英语	意大利语
英语	马来语
英语	俄语
英语	荷兰语

Language Code语言代码

语言代码采用 ISO 639-1 标准的两位字母表示法。对于特定语言的区域变体，遵循 RFC 5646 格式，即在语言代码后加短横线，并接上 ISO 3166 的两位国家/地区代码。例如，繁体中文的语言代码是 zh-tw。

点击查看语言代码code。