商品标题生成API调用说明

商品标题生成

GET/POST /ai/product/title/generation

产品描述

商品标题生成产品是基于海量电商数据进行训练的，通过简单入参，即可根据品类特性快速生成吸引力十足的标题，凸显商品优势，帮助商家获取更多流量。

请求参数

参数	类型	必填	参数描述及示例值
productName	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)"
productCategory	String[]	是	商品所属类目；您可参考任何平台的类目结构，输入商品类目名称，类目信息越详细，生成结果会越精确。 示例值: "Clothes"
targetLanguage	String	是	标题生成的目标语言； 您需要输入语言代码，详情可查看语言代码。 目前支持的语向为：详见附录支持生成标题的语向。 示例值: "es"
productKeyword	String[]	否	商品相关关键词，一般是商品SEO相关关键词或商品核心卖点词，输入信息越多，对生成结果帮助越大。 填写需要在商品标题生成过程中额外添加的关键词内容。 示例值: "sweet"
itemSpec	String	否	商品属性，商品的特征描述，例如商品的材质等。输入商品属性名称和属性内容（键1: 值1, 键2: 值2），使生成效果更加详细准确。 示例值: "Number: 12 cans, Brand: Coca Cola"
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.Scooped keys perfectly match the shape of your fingertips, offering quick response with every keystroke. Premium comfort for all-day typing.Cushioned Palm Rest: Curved palm rest with soft memory foam layer offers typing comfort with more wrist support, less wrist bending compared to standard keyboard without palm rest. Adjustable tilt design positions the keyboard at a perfect angle to keep your wrist relaxed and comfortable whether seated or standing.2.4G Wireless keyboard and Mouse comb : The keyboard and mouse share the same one USB receiverColoful keyboard and mouse!"
generateCounts	Integer	否No	生成数量；一次性生成结果的条数，可以输入整数1-6；如果不填写，默认为1。 示例值: "2"

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/product/title/generation");
request.addApiParameter("targetLanguage", "en");
request.addApiParameter("productName", "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("generateCounts", "1");
request.addApiParameter("productDescription", "Sleeve Type, style, Sleeve Length, distinctive features, category terms, benefits.");
request.addApiParameter("productKeyword", "[\"chaqueta casual mujer\",\"female blazers jacket\"]");
request.addApiParameter("itemSpec", "[\"service:dropshippingClothing\", \"style\":Europe and America\",\"pattern:Printing\",\"season:spring\"]");
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,
    "generatedTitle": [
      "Vintage Black Printing Blazer Women's High Street Fashion Office Lady Coat Elegant Plus Size Jacket for Spring 2024 American Style"
    ],
    "class": "com.aidc.service.api.client.text.dto.ProductTitleGenerationResponse"
  },
  "requestId": "2141069c17186253490176155e1cdc",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "212a714317186253490184213",
  "_trace_id_": "2141069c17186253490176155e1cdc"
}

错误码

错误码	错误信息	描述
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，入群联系我们。

源语言	目标语言
中文	英语English
中文	西班牙语Spanish
中文	法语French
中文	葡萄牙语Portuguese
中文	韩语Korean
中文	日语Japanese
中文	越南语Vietnamese
中文	泰语Thai
中文	土耳其语Turkish
中文	印尼语Indonesian
中文	德语German
中文	意大利语Italian
中文	马来语Malay
中文	俄语Russian
中文	荷兰语Dutch
英语	英语English
英语	西班牙语Spanish
英语	法语French
英语	葡萄牙语Portuguese
英语	韩语Korean
英语	日语Japanese
英语	越南语Vietnamese
英语	泰语Thai
英语	土耳其语Turkish
英语	印尼语Indonesian
英语	德语German
英语	意大利语Italian
英语	马来语Malay
英语	俄语Russian
英语	荷兰语Dutch

语言代码

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

点击查看语言代码code。