# 文本相似度对文本对进行相似度计算。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/text-similarity

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

请求头部：

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

请求参数：

{ 
    "text1":"今天天气晴朗",
    "text2":"今天天气晴",
    "lang":"zh"
}

请求参数说明：

参数	必选	参数类型	说明
text1	是	String	待计算文本1，长度1~512，文本编码为UTF-8。
text2	是	String	待计算文本2，长度1~512，文本编码为UTF-8。
lang	否	String	支持的文本语言类型，默认为zh。目前只支持中文。

请求示例：

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/nlp/text-similarity' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"text1":"今天天气晴朗","text2":"今天天气晴","lang":"zh"}'

响应格式说明

返回结果

正常返回结果

{
    "code": "0",
    "data": {
        "similarity":0.92014253
    },
    "error": "",
    "message": "ok"
}

异常返回结果

文本相似度失败响应示例

{
    "code": "58002",
    "data": null,
    "error": "argument valid error:text2.text2 for text similarity should be between 1 to 512 ;text2.must not be blank;",
    "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 数据结构

参数	必选	参数类型	说明
similarity	是	Float	相似度得分，范围在0~1，默认小数点后保留8位。

错误码说明

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

响应格式说明

结果。 ""

无结果。 ""