키워드 및 토픽 추출
텍스트 분석 서비스 중텍스트에서 주요 키워드와 핵심 주제(Topic)를 추출합니다.
API 키 필수
HTTPS
POST
/api/v1/keyword/extract
API 설명
키워드 및 토픽 추출 API는 지능형 AI 모델을 통해 긴 텍스트 문서 내에서 가장 중요한 핵심 단어들과 주요 주제를 자동으로 식별하여 리스트 형태로 반환합니다.
- 핵심 키워드 자동 추출
- 주요 주제(Topic) 분류 및 식별
- 데이터 마이닝 및 콘텐츠 분석 최적화
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/keyword/extract
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 분석할 원문 텍스트 (최대 3,000자 제한) |
### 응답 결과
```json
{
"success": true,
"keywords": ["인공지능", "미래", "기술"],
"topics": ["기술 트렌드", "사회 변화"],
"api": "keyword-extraction",
"remaining": 99
}
```
### 오류 코드
| 코드 | 메시지 | 원인 및 해결 방법 |
| :--- | :--- | :--- |
| **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/keyword/extract \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"..."}'