AI APIALPHA

감성분석 API

문서에 대한 긍정/부정 뿐만 아니라, 문서에 나타난 개체에 대한 긍정/부정도 추출하여 반환합니다.

요청정보

이 API를 호출하기 위해서는 사용자에게 할당된 API Key 가 필요합니다. 회원가입 후에 무료로 발급받을 수 있습니다.

요청정보
URL https://api.matgim.ai/54edkvw2hn/api-sentiment
METHOD POST
헤더
Content-Type: application/json
x-auth-token: [your-api-key]

입력필드

문서 본문에 json 형태로 입력합니다. document 필드의 1회 최대 호출 가능 글자수는 1,000자입니다.

입력필드
요청변수 값 설명 예제 필수
document string 키워드를 추출할 문서 (최대 1,000자) 데이탄소프트 O

출력필드

출력 결과는 문장과 키워드로 구분되어 반환됩니다.

출력필드
응답변수 값 설명
document_score.score number 문서의 긍/부정 점수 (문장의 긍/부정의 합)
document_score.pos_score number 문서의 긍정 점수 (문장의 긍정 점수 합)
document_score.neg_score number 문서의 부정 점수 (문장의 부정 점수 합)
sentence_score.sentence string 문장
sentence_score.score number 문장의 긍/부정 점수
target_score.key string 식별된 개체 (고유명사)
target_score.value number 개체의 긍/부정 점수

샘플요청

요청의 본문은 아래와 같이 json 형식으로 이루어집니다.

curl -X POST \
  https://api.matgim.ai/54edkvw2hn/api-keyword \
  -H 'content-type: application/json' \
  -H 'x-auth-token: [your-api-key]' \
  -d '{
	"document": "감성분석 API 입니다. 모두 즐거운 하루 보내세요!"
}'

샘플결과

요청의 결과도 json 형식으로 이루어집니다. 오류가 없을 경우 단어와 빈도의 조합이 반환됩니다.

{
    "document_score": {
        "score": 0.12204139495675209,
        "pos_score": 0.12204139495675209,
        "neg_score": 0
    },
    "sentence_score": [
        {
            "sentence": "감성분석 API 입니다.",
            "score": 0.04009395295885464
        },
        {
            "sentence": "모두 즐거운 하루 보내세요!",
            "score": 0.08194744199789745
        }
    ],
    "target_score": {
        "API": 0.04009395295885464
    }
}

에러코드

요청 처리에 문제가 생겨서 에러가 발생할 경우, 아래와 같이 HTTP 응답 코드로 반환됩니다.

에러코드
응답코드 설명
400 Bad Request Exception
403 Access Denied Exception
404 Not Found Exception
409 Conflict Exception
429 Limit Exceeded Exception
429 Too Many Requests Exception
500 Unexpected Exception
503 Service Unavailable Exception
504 Endpoint Request Timed-out Exception
목록으로
페이지 상단으로 이동