4.2 语言生成服务接口说明
4.2.2 文本摘要（领域版）
} catch (Exception e) { e.printStackTrace();
} }
public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo();
nlpDemo.nlpDemo();
} }
● 响应示例
– 成功响应示例
{ "summary" : "华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界的创新解决 方案。自2012年推出以来，刀片式基站全球累计已发货超1500万片，在全球超过170个国家310张运 营商网络中成功商用部署。在5G时代，华为围绕客户需求持续创新，在2018全球移动宽带论坛上，
华为亦推出Super Blade Site——面向5G全室外站解决方案，其中包含最新支持5G容量要求的室外基 带单元Blade BBU和有源天线一体化产品Blade AAU，该解决方案进一步匹配5G的最新技术要求和容 量要求，极大降低5G引入对天面空间的需求，加速Massive MIMO部署，帮助运营商布局5G网络。
华为Super Blade Site在2018全球移动宽带论坛上展出华为无线网络研发总裁郦舟剑表示，“华为一 直致力于围绕客户需求持续创新，刀片式基站就是典型的例子。”国家科学技术进步奖，是国务院设 立的国家科学技术奖5大奖项（国家最高科学技术奖、国家自然科学奖、国家技术发明奖、国家科学 技术进步奖、国际科学技术合作奖）之一。"
}
– 失败响应示例
{ "error_code": "NLP.3201", "error_msg": "parameter error."
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
4.2.2 文本摘要（领域版）
功能介绍
根据不同领域的语料训练特定领域的摘要模型，能有效提升文本摘要的效果。
文本摘要（基础版）和文本摘要（领域版）基于不同算法实现，对相同文本，基础版 和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。
本API免费调用，调用限制为2次/秒。
调试
您可以在API Explorer中调试该接口。
前提条件
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和
认证鉴权章节。
说明
用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通 服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注 意开通服务区域与调用服务的区域保持一致。
URI
● URI格式
POST /v1/{project_id}/nlg/summarization/domain
● 参数说明
表4-49 URI 参数说明
名称 是否必选 说明
project_id 是 项目编号。获取方法，请参见获取项目
ID。
请求消息
请求参数如下所示。
表4-50 请求参数
名称 是否必
选 参数类型 说明
lang 否 String 支持的文本语言类型，目前支持中文
（zh），默认为中文。
title 否 String 文本标题（目前仅支持UTF-8编码），长度 不超过1000字。
content 是 String 文本正文（目前仅支持UTF-8编码），长度 1~10000字。
length_limit 否 float 生成摘要的长度限制。
● length_limit > 1，则为摘要的具体字数。
● 0 <= length_limit <= 1，则为生成摘要占 原文长度的百分比。
默认数值为0.3。
type 否 Integer 支持的领域类型，取值如下（目前只支持通 用领域），默认为通用领域：
0：通用领域
响应消息
响应参数如表4-51所示。
表4-51 响应参数
名称 参数类型 说明
summary String 根据文本请求体，返回摘要结果。
error_code String 调用失败时的错误码，具体参见错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
调用成功时无此字段。
Content-Type: application/json X-Auth-Token:
MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... //用户认证 获取的token值，获取方法详细请参考“如何调用API”章节中的“认证鉴权”页面。 客户需求持续创新，在2018全球移动宽带论坛上，华为亦推出Super Blade Site——面向5G全室外站解决方 案，其中包含最新支持5G容量要求的室外基带单元Blade BBU和有源天线一体化产品Blade AAU，该解决方 案进一步匹配5G的最新技术要求和容量要求，极大降低5G引入对天面空间的需求，加速Massive MIMO部 署，帮助运营商布局5G网络。华为Super Blade Site在2018全球移动宽带论坛上展出华为无线网络研发总裁 郦舟剑表示，“华为一直致力于围绕客户需求持续创新，刀片式基站就是典型的例子。刀片式基站解决客
-*-# 此demo仅供测试使用，建议使用sdk。需提前安装requests，执行pip install requests
import requests import json def nlp_demo():
url = 'https://{endpoint}/v1/{project_id}/nlg/summarization/domain' # endpoint和project_id需替换 token = '用户对应region的token' 客户需求持续创新，在2018全球移动宽带论坛上，华为亦推出Super Blade Site——面向5G全室外站解决方 案，其中包含最新支持5G容量要求的室外基带单元Blade BBU和有源天线一体化产品Blade AAU，该解决方 案进一步匹配5G的最新技术要求和容量要求，极大降低5G引入对天面空间的需求，加速Massive MIMO部 署，帮助运营商布局5G网络。华为Super Blade Site在2018全球移动宽带论坛上展出华为无线网络研发总裁 郦舟剑表示，“华为一直致力于围绕客户需求持续创新，刀片式基站就是典型的例子。刀片式基站解决客
resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.text)
if __name__ == '__main__':
nlp_demo() */public class NLPDemo {
public void nlpDemo() { try {
//endpoint和projectId需要替换成实际信息。
URL url = new URL("https://{endpoint}/v1/{project_id}/nlg/summarization/domain");
String token = "对应region的token";
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("POST");
connection.setDoInput(true);
connection.setDoOutput(true);
connection.addRequestProperty("Content-Type", "application/json");
connection.addRequestProperty("X-Auth-Token", token);
//输入参数
String title = "小德3-0费德勒首进澳网决赛 天王遭遇08年首败";
String content = "搜狐体育讯 北京时间1月25日,2008年首项大满贯赛事--澳大利亚网球公开赛进
String body = "{\"title\":\"" + title + "\",\"content\":\"" + content + "\",\"length_limit\":
0.3,\"lang\": \"zh\",\"type\": 0}";
OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(),
"UTF-8");
osw.append(body);
osw.flush();
InputStream is = connection.getInputStream();
BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
while (br.ready()) {
public static void main(String[] args) { NLPDemo nlpDemo = new NLPDemo();
{ "error_code": "NLP.3104", "error_msg": "content is empty."
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。