말투 변환
텍스트 처리 서비스 중입력된 텍스트를 원하는 말투(격식, 친근, 비즈니스 등)로 자연스럽게 변환합니다.
API 키 필수
HTTPS
POST
/api/v1/tone/transform
API 설명
말투 변환 API는 AI가 문맥과 의미를 정확히 파악하여, 사용자가 원하는 다양한 어투로 문장을 재구성해 줍니다.
- 격식 있는 정중한 표현 (하십시오 체)
- 친근하고 부드러운 일상 표현 (해요 체)
- 신뢰감을 주는 전문적인 비즈니스 표현
- 감동과 여운을 주는 감성적인 표현
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/tone/transform
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 변환할 원문 텍스트 (최대 3,000자 제한) |
| target_tone | String | N | 대상 말투 (기본: formal) |
### 대상 말투 종류
| 코드 (target_tone) | 말투 종류 | 스타일 가이드 및 예시 |
| :--- | :--- | :--- |
| **formal** | 격식 있음 | 하십시오 체 (정중하고 정제된 표현) |
| **casual** | 친근함 | 해요 체 (자연스럽고 부드러운 일상어) |
| **informal** | 반말 | 해 체 (가깝고 편안하게 사용하는 반말) |
| **professional** | 비즈니스 | 전문가 느낌의 신뢰감 있는 비즈니스 문투 |
| **emotive** | 감성적 | 감정이 풍부하고 따뜻한 여운이 담긴 표현 |
| **child** | 어린이 | 순수하고 천진난만한 아이들의 말투 |
| **cute** | 애교쟁이 | 애교가 듬뿍 섞인 귀엽고 발랄한 말투 |
| **lovely** | 사랑스럽게 | 다정하고 사랑스러운 느낌의 따뜻한 말투 |
| **elder** | 노인 | 부드럽고 연륜이 느껴지는 노년의 문체 |
| **thug** | 건달 | 거칠고 화끈한 매력의 느와르 스타일 어투 |
### 응답 결과
```json
{
"success": true,
"transformed_text": "변환된 결과 문장입니다.",
"api": "tone-transformation",
"remaining": 99
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/tone/transform \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"..."}'