텍스트 요약
텍스트 처리 서비스 중긴 문서나 기사를 핵심 내용만 빠르게 요약합니다.
API 키 필수
HTTPS
POST
/api/v1/text/summary
API 설명
AI 기반 텍스트 요약 API는 자연어 처리(NLP) 기술을 활용하여 긴 문서, 기사, 보고서 등을 핵심 내용만 간결하게 요약합니다.
- 최대 10,000자 입력 지원
- 한국어/영어 최적화
- 문맥을 파악한 자연스러운 요약 제공
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/text/summary
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 요약할 원문 텍스트 (최대 10,000자) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| summary | String | 요약된 결과 텍스트 |
| api | String | 호출된 API 식별값 (text-summary) |
| remaining | Integer | 잔여 호출 횟수 |
### 오류 코드
| 코드 | 메시지 | 설명 |
| :--- | :--- | :--- |
| 400 | Bad Request | 요약할 원문 텍스트 누락 |
| 401 | Unauthorized | 유효하지 않은 API Key |
| 429 | Too Many Requests | 호출 한도 초과 |
| 500 | Internal Error | 서버 내부 오류 또는 AI 모델 지연 |
### 응답 예시
```json
{
"success": true,
"summary": "요약된 내용입니다.",
"api": "text-summary",
"remaining": 99
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/text/summary \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"요약할 원문 텍스트입니다."}'