4.2 语言生成服务接口说明
4.2.1 文本摘要（基础版）
{
"role": "Time-Period", "span": [57,69],
"word": "任期与本届董事会任期一致"
} ],
"event_trigger": "选举", "event_type": "聘任", "trigger_span": [36,38]
} ] }
– 失败响应示例
{ "error_code": "NLP.0301",
"error_msg": "text should be between 1 to 256."
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
4.2 语言生成服务接口说明
4.2.1 文本摘要（基础版）
功能介绍
对文本生成摘要。
文本摘要（基础版）和文本摘要（领域版）基于不同算法实现，对相同文本，基础版 和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。
具体Endpoint请参见终端节点。
调用华为云NLP服务会产生费用，本API支持使用基础套餐包，购买时请在自然语言处
理价格计算器中查看基础套餐包和领域套餐包支持的API范围。
调试
您可以在API Explorer中调试该接口。
前提条件
在使用本API之前，需要您完成服务申请和认证鉴权，具体操作流程请参见申请服务和
认证鉴权章节。
说明
用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通 服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注 意开通服务区域与调用服务的区域保持一致。
URI
● URI格式
POST /v1/{project_id}/nlg/summarization
● 参数说明
表4-46 URI 参数说明
参数名 必选 说明
project_id 是 项目编号。获取方法，请参见获取项目ID。
请求消息
请求参数如表4-47所示。
表4-47 请求参数
参数名 参数类
型
必选 说明
lang String 否 支持的文本语言类型，目前支持中文（zh）
和英文（en），默认为中文。
title String 否 文本标题（目前仅支持UTF-8编码），长度 为0~1000。
content String 是 文本正文（目前仅支持UTF-8编码），长度 为1~10000。
说明文本语言类型需和lang字段保持一致。
length_limit Float 否 生成摘要的长度限制。
● length_limit > 1，则返回结果为字数最接 近该值的摘要。
● 0 <= length_limit <= 1，则返回结果为长 度百分比最接近该值的摘要。
默认数值为0.3。
响应消息
响应参数如表4-48所示。
表4-48 响应参数
参数名 参数类型 说明
summary String 根据文本请求体，返回摘要结果。
参数名 参数类型 说明
error_code String 调用失败时的错误码，具体参见错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
调用成功时无此字段。
示例
● 请求示例
Request Header:
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' # endpoint和project_id需替换 token = '用户对应region的token'
'content': '华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界的创新解决方案。 客户需求持续创新，在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");
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 body = "{\"title\":\"" + title + "\",\"content\":\"" + content + "\",\"length_limit\":
0.3,\"lang\": \"zh\"}";
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()) {
System.out.println(br.readLine());
}
} 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."
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。