감정분석
- 인쇄
- PDF
감정분석
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
감정분석 API
텍스트 데이터를 분석해서 해당 단어/문장/문구 내용의 감정을 분석하는 서비스로 그 결과를 반환하는 HTTP 기반의 REST API입니다.
요청
POST https://naveropenapi.apigw-pub.fin-ntruss.com/sentiment-analysis/v1/analyze
요청 헤더
헤더명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-NCP-APIGW-API-KEY:{Client Secret} |
Content-Type | 바이너리 전송 형식Content-Type: application/json |
요청 바디
필드명 | 필수 여부 | 타입 | 설명 |
---|---|---|---|
content | Yes | String | 감정분석 Text |
응답
응답 바디
필드 이름 | 데이터 타입 | 설명 |
---|---|---|
document | Object | 전체 문장 관련 object |
document.sentiment | String | 전체 문장에 대한 감정 |
document.confidence | Object | 전체 문장에 대한 감정 confidence |
document.confidence.neutral | Float | 중립 confidence (%) |
document.confidence.positive | Float | 긍정 confidence (%) |
document.confidence.negative | Float | 부정 confidence (%) |
sentences | List of Object | 분류 문장 관련 list object |
sentences.content | String | 분류 문장 |
sentences.offset | Int | document.content 에서 문장 시작 위치 |
sentences.length | Int | 분류 문장 글자 수 |
sentences.sentiment | String | 분류 문장 감정 |
sentences.confidence | Object | 분류 문장에 대한 감정 confidence |
sentences.confidence.neutral | Float | 중립 confidence (%) |
sentences.confidence.positive | Float | 긍정 confidence (%) |
sentences.confidence.negative | Float | 부정 confidence (%) |
sentences.highlights | List of Object | sentences.content 에서 감정분석 구간 |
sentences.highlights.offset | Int | 주요 감정 구간 시작 위치 |
sentences.highlights.length | Int | 주요 감정 구간 글자 수 |
sentences.negativeSentiment.sentiment | String | 부정 감정일 경우, 세부 감정 |
sentences.negativeSentiment.confidence | Float | 부정 감정일 경우, 세부 감정에 대한 confidence |
예시
요청 예시
{
"content": "싸늘하다. 가슴에 비수가 날아와 꽂힌다."
}
응답 예시
{
"document": {
"sentiment": "negative",
"confidence": {
"neutral": 0.14525136640572725,
"positive": 0.00186876227013191,
"negative": 0.8528798713241407
}
},
"sentences": [
{
"content": "싸늘하다.",
"offset": 0,
"length": 5,
"sentiment": "negative",
"confidence": {
"negative": 0.9961358904838562,
"positive": 0.0036366574931889772,
"neutral": 0.0002274021098855883
},
"highlights": [
{
"offset": 0,
"length": 4
}
]
},
{
"content": " 가슴에 비수가 날아와 꽂힌다.",
"offset": 5,
"length": 17,
"sentiment": "negative",
"confidence": {
"negative": 0.927976131439209,
"positive": 0.07131962478160858,
"neutral": 0.0007042606011964381
},
"highlights": [
{
"offset": 1,
"length": 15
}
]
}
]
}
오류
오류 예시
{
"status": 400,
"error": {
"errorCode": "E001",
"message": "Unsupported empty or blank text"
}
}
오류 코드
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | E001 | Unsupported empty or blank text | 빈 문자열 or blank 문자 |
400 | E002 | Utf-8 encoding error | UTF-8 인코딩 에러 |
400 | E003 | Text quota Exceeded | 문장이 기준치보다 초과 했을 경우 |
400 | E103 | Invalid request body | request body의 json format이 유효하지 않거나 필수 파라미터가 누락된 경우 |
400 | E415 | Unsupported media type | content-type 에러 |
400 | E900 | Unexpected error | 예외처리가 안된 경우(Bad Request) |
500 | E501 | Endpoint connection failed | 엔드포인트 연결 실패 |
500 | E900 | Unexpected error | 예외처리가 안된 오류(Server Error) |
이 문서가 도움이 되었습니까?