감성 분석
감성/감정 서비스 중텍스트의 감성(긍정/부정/중립)을 정밀하게 분석합니다.
API 키 필수
HTTPS
POST
/api/v1/sentiment
API 설명
감성 분석 API는 입력된 텍스트에서 긍정, 부정, 중립 감성을 감지하고 신뢰도 점수를 제공합니다.
- 긍정/부정/중립 분류
- 0~1 사이 신뢰도 점수
- 문장 단위 분석 지원
- 감정 키워드 추출
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/sentiment
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 분석할 원문 텍스트 (최대 3,000자 제한) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| sentiment | String | 감성 분류 (positive, negative, neutral) |
| score | Float | 분석 신뢰도 점수 (0.0 ~ 1.0) |
| keywords | Array | 분석 근거가 되는 주요 키워드 리스트 |
### 오류 코드
| 코드 | 메시지 | 원인 및 해결 방법 |
| :--- | :--- | :--- |
| **400** | 분석할 원문 텍스트는 최대 3,000자까지 입력 가능합니다. | 요청 텍스트가 글자수 제한(3,000자)을 초과했습니다. |
| **401** | 유효하지 않은 API 키입니다. | API 키 인증에 실패했습니다. |
| **429** | 사용 가능 횟수를 모두 소진하였습니다. | 서비스 호출 할당량을 초과했습니다. |
| **500** | 감성 분석 중 서버 오류 발생 | AI 엔진과 통신 중 오류가 발생했습니다. |
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/sentiment \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"훌륭한 서비스네요!"}'