# 文本摘要生成对文本生成摘要。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/summarization

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json
x-wlk-Authorization: access_token

请求参数：

{
    "lengthLimit": 0.3,
    "title": "华为“刀片式基站”获2018年度国家科学技术进步奖一等奖",
    "lang": "zh",
    "content": "华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界的创新解决方案。该方案..."
}

请求参数说明：

参数	必选	参数类型	说明
content	是	String	文本正文（目前仅支持UTF-8编码），长度为1~10000。（注：文本语言类型需和lang字段保持一致）
title	否	String	文本标题（目前仅支持UTF-8编码），长度为0~1000。
lang	否	String	支持的文本语言类型，目前支持中文（zh）和英文（en），默认为中文。
lengthLimit	否	String	生成摘要的长度限制。 lengthLimit > 1，则返回结果为字数最接近该值的摘要。 0 <= lengthLimit <= 1，则返回结果为长度百分比最接近该值的摘要。默认数值为0.3。

请求示例：

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/summarization' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"lengthLimit": 0.3,"title": "华为“刀片式基站”获2018年度国家科学技术进步奖一等奖","lang": "zh","content": "华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界的创新解决方案。该方案..."}'

响应格式说明

返回结果

正常返回结果

{
    "code": "0",
    "data": {
        "summary" : "华为刀片式基站解决方案是华为在深入理解客户诉求基础上，引领业界..."
    },
    "error": "",
    "message": "ok"
}

异常返回结果

文本摘要生成失败响应示例

{
    "code": "58002",
    "data": null,
    "error": "parameter error.",
    "message": "NLP service call exception"
}

Token验证失败响应示例

{
    "code": "58401",
    "data": null,
    "error": "Failed to verify the token.",
    "message": "Login authentication failed."
}

返回参数说明

参数	必选	参数类型	说明
code	是	String	错误码
message	是	String	调用成功时为"ok"。调用失败时的错误信息。
data	是	Object	调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error	是	String	错误信息。

data 数据结构

参数	必选	参数类型	说明
summary	是	String	根据文本请求体，返回摘要结果。

错误码说明

错误码	说明
0	成功。
58401	无权限。
58402	非法参数异常。
58500	服务异常。
58002	NLP服务异常。

响应格式说明

结果。 ""

无结果。 ""