DetectSentiment - Amazon Comprehend

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DetectSentiment

检查文本并返回对流行情绪的推断(POSITIVENEUTRALMIXED,或者NEGATIVE)。

请求语法

{ "LanguageCode": "string", "Text": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅常见参数.

请求接受采用 JSON 格式的以下数据。

LanguageCode

输入文档的语言。您可以指定 Amazon Comprehend 支持的任何主要语言。所有文档必须使用相同的语言。

类型: 字符串

有效值: en | es | fr | de | it | pt | ar | hi | ja | ko | zh | zh-TW

必需: 是

Text

UTF-8 文本字符串。最大字符串大小为 5 KB。

类型: 字符串

长度约束:最小长度为 1。

必需: 是

响应语法

{ "Sentiment": "string", "SentimentScore": { "Mixed": number, "Negative": number, "Neutral": number, "Positive": number } }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

Sentiment

推断出的亚马逊理解(Amazon Comprehend)最有信心的情绪。

类型: 字符串

有效值: POSITIVE | NEGATIVE | NEUTRAL | MIXED

SentimentScore

列出情绪及其相应置信水平的对象。

类型:SentimentScore 对象

错误

有关所有操作常见错误的信息,请参阅常见错误.

InternalServerException

发生内部服务器错误。重试您的请求。

HTTP 状态代码:500

InvalidRequestException

该请求无效。

HTTP 状态代码:400

TextSizeLimitExceededException

输入文本的大小超过限制。使用较小文档。

HTTP 状态代码:400

UnsupportedLanguageException

Amazon Comprehend 无法处理输入文本的语言。对于自定义实体识别 API,仅接受英语、西班牙语、法语、意大利语、德语或葡萄牙语。有关支持的语言的列表,支持的语言(在开发人员指南中)。

HTTP 状态代码:400

示例

检测情绪

如果输入的文字是 “今天是我的生日,我很高兴。 “,操作返回以下响应:

{ "SentimentScore": { "Mixed": 0.0033542951568961143, "Positive": 0.9869875907897949, "Neutral": 0.008563132025301456, "Negative": 0.0010949420975521207 }, "Sentiment": "POSITIVE", } }

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: