5.2 自然语言处理基础
5.4.2 文本摘要（基础版）
前提条件
● 已完成Python环境配置，详细请参见配置Python环境。
● 已完成SDK环境配置，详细请参见SDK环境配置。
● 已完成NlgClient初始化 ，详细请参见初始化Client。
操作须知
为方便用户使用，SDK 中包含了样例工程，用户可下载使用，详细请参见Python SDK 解压目录下的demo文件NlgClient.py，Python SDK文件下载路径python sdk。
样例关键操作如下
# 根据初始化Client章节选择认证方式构造完成nlgClient后调用
response = nlgClient.summary("华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界的创新解 决方案。"
,"华为", None, "zh")
# 结果为code和json结构体 print(response.code)
print(json.dumps(response.res,ensure_ascii=False))
方法参数说明
NlgClient.summary(content, title, length_limit, lang)
表5-25 文本摘要基础版参数说明
参数名 参数类型 是否必须 说明
content String 是 文本正文（目前仅支持
UTF-8编码），长度为 1~10000。（注：文本 语言类型需和lang字段 保持一致）。
参数名 参数类型 是否必须 说明
length_limit Float 否 生成摘要的长度限制。
● length_limit > 1，则 返回结果为字数最接 近该值的摘要。
● 0 <= length_limit <=
1，则返回结果为长
code Integer 响应码，意义同HTTP 返
回的响应code。具体值参
● 已完成Python环境配置，详细请参见配置Python环境。
● 已完成SDK环境配置，详细请参见SDK环境配置。
● 已完成NlgClient初始化 ，详细请参见初始化Client。
操作须知
为方便用户使用，SDK 中包含了样例工程，用户可下载使用，详细请参见Python SDK 解压目录下的demo文件NlgClient.py，Python SDK文件下载路径python sdk。
样例关键操作如下
# 根据初始化Client章节选择认证方式构造完成nlgClient后调用
response = nlgClient.domain_summary("华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界 的创新解决方案。"
,"华为", None, "zh", 0)
# 结果为code和json结构体 print(response.code)
print(json.dumps(response.res,ensure_ascii=False))
方法参数说明
NlgClient.summary(content, title, length_limit, lang, type)
表5-27 文本摘要领域版参数说明
参数名 参数类型 是否必须 说明
content String 是 文本正文（目前仅支持
UTF-8编码），长度为 1~10000。（注：文本 语言类型需和lang字段 保持一致）。
length_limit Float 否 生成摘要的长度限制。
● length_limit > 1，则 返回结果为字数最接 近该值的摘要。
● 0 <= length_limit <=
1，则返回结果为长
表5-28 文本摘要领域版返回对象数据结构
参数名 类型 说明
code Integer 响应码，意义同HTTP 返
回的响应code。具体值参 考 响应码。
res JSON对象 数据结构参考文本摘要
（领域版）的响应消息。
5.4.4 诗歌生成
前提条件
● 已完成Python环境配置，详细请参见配置Python环境。
● 已完成SDK环境配置，详细请参见SDK环境配置。
● 已完成NlgClient初始化 ，详细请参见初始化Client。
操作须知
为方便用户使用，SDK 中包含了样例工程，用户可下载使用，详细请参见Python SDK 解压目录下的demo文件NlgClient.py，Python SDK文件下载路径python sdk。
样例关键操作如下
# 根据初始化Client章节选择认证方式构造完成nlgClient后调用 response = nlgClient.generate_poem("写诗", 0, False)
# 结果为code和json结构体 print(response.code)
print(json.dumps(response.res,ensure_ascii=False))
方法参数说明
NlgClient.generate_poem(title, type, acrostic)
表5-29 诗歌生成参数说明
参数名 参数类型 是否必须 说明
title String 是 诗歌标题，目前仅支持
UTF-8编码，仅支持中 文，长度为1-10。
type Integer 是 诗歌类型，取值如下：
0：五言绝句；
1：七言绝句；
2：五言律诗；
3：七言律诗；
参数名 参数类型 是否必须 说明
acrostic boolean 否 藏头诗，取值如下：
取值为true，为藏头
code Integer 响应码，意义同HTTP 返
回的响应code。具体值参 考 响应码。
res JSON对象 数据结构参考诗歌生成的
响应消息。
5.5 机器翻译
5.5.1 初始化 Client
MtClient 是访问机器翻译的工具类，通过构造认证信息类和选择认证方式去初始化 MtClient ，然后用对应实例去访问接口。初始化支持AK/SK认证和用户名密码认证两 种方式。
用户名密码（Token）认证方式
import json
from huaweicloud_nlp.MtClient import MtClient
from huaweicloud_nlp.HWNlpClientToken import HWNlpClientToken
tokenClient = HWNlpClientToken("domain-name", # domain name，用户的domain name "username", # 用户名
"password", # 密码 "cn-north-4", # region
"058ac67cb6100f602f6bc002d454b770") # project_id
proxy = {"http": "http://username:[email protected]", "https": "http://username:[email protected]"}
# 如果需要，可以使用http代理，否则不需要
tokenClient.set_proxy(proxy) # 如果需要，可以使用http代理，否则不需要 mtClient = MtClient(tokenClient)
AK/SK 认证方式
import json
from huaweicloud_nlp.MtClient import MtClient
from huaweicloud_nlp.HWNlpClientAKSK import HWNlpClientAKSK akskClient = HWNlpClientAKSK("ak", # 用户的ak
"sk", # 用户的sk "cn-north-4", # region值
"058ac67cb6100f602f6bc002d454b770") # projectId
proxy = {"http": "http://username:[email protected]", "https": "http://username:[email protected]"}
# 如果需要，可以使用http代理，否则不需要
akskClient.set_proxy(proxy) # 如果需要，可以使用http代理，否则不需要 mtClient= MtClient(akskClient)
5.5.2 文本翻译
前提条件
● 已完成Python环境配置，详细请参见配置Python环境。
● 已完成SDK环境配置，详细请参见SDK环境配置。
● 已完成MtClient初始化 ，详细请参见初始化Client。
操作须知
为方便用户使用，SDK 中包含了样例工程，用户可下载使用，详细请参见Python SDK 解压目录下的demo文件，Python SDK文件下载路径python sdk。
样例关键操作如下
# 根据初始化Client章节选择认证方式构造完成mtClient后调用
response = mtClient.translate_text("how are you", "en", "zh", "common")
# 结果为code和json结构体 print(response.code)
print(json.dumps(response.res,ensure_ascii=False))
方法参数说明
MtClient.translate_text(text, fromLang, to, scene)
表5-31 文本翻译参数说明
参数名 参数类型 是否必须 说明
text String 是 仅支持utf-8编码，长度
不超过1000字符。
fromLang Integer 是 翻译原语言，具体取值
见翻译支持语言表。
to String 是 翻译目标语言，具体取
值见翻译支持语言表。
scene String 否 默认为“common”，
当前只有通用场景。
表5-32 支持的语言列表
语言 说明
zh 中文
en 英文
ja 日文
ru 俄文
ko 韩语
fr 法语
es 西班牙语
de 德语
auto 自动检测输入语种并翻译成目标语种，您需要指定目
标语种。
返回数据结构
返回值为对象Response
表5-33 文本翻译返回对象数据结构
参数名 类型 说明
code Integer 响应码，意义同HTTP 返
回的响应code。具体值参 考 响应码。
res JSON对象 数据结构参考文本翻译的
响应消息。
5.5.3 语种识别
样例如下
# 根据初始化Client章节选择认证方式构造完成mtClient后调用 response = mtClient.detect_language("how are you")
# 结果为code和json结构体 print(response.code)
print(json.dumps(response.res,ensure_ascii=False))
方法参数说明
MtClient.detect_language(text)
表5-34 语种识别参数说明
参数名 参数类型 是否必须 说明
text String 是 需要识别语种的文本，
具体支持的语种见语种
识别支持的语言列表章
节。仅支持utf-8编码，长度 不超过1000字符。
返回数据结构
返回值为对象Response
表5-35 语种识别返回对象数据结构
参数名 类型 说明
code Integer 响应码，意义同HTTP 返
回的响应code。具体值参 考 响应码。
res JSON对象 数据结构参考语种识别的
响应消息。
A 修订记录
发布日期 修订说明
2021-12-1 新增