TBD通用营销文案生成API调用说明

通用营销文案生成

GET/POST /ai/marketing/message/generation

产品描述

通用营销文案生成产品为每个商品生成丰富且本地化的多语言营销内容，满足不同场景、渠道及受众的需求，帮助商家提升产品曝光率、增加流量。

请求参数

参数	类型	必填	参数描述及示例值
marketScene	String	是	营销文案支持以下几个模板，每个模板对应一种使用场景： 模版1：Marketing Short Title 参数名称：General（通用营销短文案） 适用场景：用于话题标签、电子邮件、推广页面短标签等。 模版2： Product Slogan 参数名称：Product_Slogan （商品营销文案） 适用场景：用于通过电子邮件、推送通知和社交媒体推广产品等。 模版3：Customer Behavioral Marketing (Cart Abandonment) 参数名称：Scenario_shopping_cart（购物车下单挽回营销文案） 适用场景：用于客户行为营销（购物车弃单）。
sourceLanguage	String	是	原始输入的语向，这里需要输入语言代码，您可查看附录语言代码。 示例值："en"
targetLanguage	String	是	目标生成的语向，这里需要输入语言代码，您可查看附录语言代码。 示例值："fr"
productTitle	String	是	商品标题，您可以填写商品原始的名称或者标题。 示例值："Clean & Clear Blackhead Eraser Facial Scrub with Salicylic Acid, 7 oz"
productCategory	List<String>	是	商品所属类目，可参考任何平台的类目结构，输入商品类目名称。当使用场景为商品营销文案类（Product Slogan）的时候，是必填。 示例值："Jewelry & Accessories"
keywords	List<String>	否	商品关键词，一般是商品SEO相关关键词或商品核心卖点词，输入越多，对生成结果帮助越大。

请求示例

Java

IopClient client = new IopClient(url, appkey, appSecret);
IopRequest request = new IopRequest();
request.setApiName("/ai/marketing/message/generation");
request.addApiParameter("marketScene", "General");
request.addApiParameter("targetLanguage", "en");
request.addApiParameter("keywords", "[\"female blazers jacket\"]");
request.addApiParameter("productCategory", "[\"Blazers\"]");
request.addApiParameter("productTitle", "Vintage Black Printing Blazer Women Jacket High Street Fashion 2024 Spring Plus Size Elegant Office Lady Coat American Stylish");
request.addApiParameter("sourceLanguage", "en");
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": {
    "generatedText": [
      "Stylo Presenteur Sans Fil 2.4GHz - Contrôle à Distance USB RF pour Présentations Powerpoint - Pointeur de Présentation Flippant"
    ]
  },
  "requestId": "2102f6cb17192865354713083e8d50",
  "success": true,
  "resCode": 200,
  "resMessage": "success",
  "code": "0",
  "request_id": "212a664f17192865354782564",
  "_trace_id_": "2102f6cb17192865354713083e8d50"
}

错误码

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

Appendix附录

支持生成通用营销文案的语向

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

源语言	目标语言
英语	English英语
英语	Spanish西班牙语
英语	French法语
英语	Portuguese葡萄牙语
英语	Korean韩语

语言代码

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

请点击查看语言代码code。