번역
언어 처리 서비스 중100개 이상 언어 간 고품질 AI 번역 서비스를 제공합니다.
API 키 필수
HTTPS
POST
/api/v1/translate
API 설명
번역 API는 한국어, 영어, 일본어, 중국어 간의 상호 번역을 지원하며 자연스러운 번역 품질을 제공합니다.
- 지원 언어: 한국어(ko), 영어(en), 일본어(ja), 중국어(zh)
- 자동 언어 감지 지원
- 문맥을 고려한 고성능 번역 모델 활용
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/translation/translate
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| text | String | Y | 번역할 원문 텍스트 (최대 3,000자 제한) |
| source_lang | String | N | 원문 언어 코드 (ko, en, ja, zh, auto / 기본 auto) |
| target_lang | String | Y | 대상 언어 코드 (ko, en, ja, zh) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| translated | String | 번역 완료된 결과 텍스트 |
| source_lang | String | 감지된 원문 언어 코드 |
| target_lang | String | 변환된 대상 언어 코드 |
### 오류 코드
| 코드 | 메시지 | 원인 및 해결 방법 |
| :--- | :--- | :--- |
| **400** | 번역할 원문 텍스트는 최대 3,000자까지 입력 가능합니다. | 요청 텍스트가 글자수 제한(3,000자)을 초과했습니다. |
| **401** | 유효하지 않은 API 키입니다. | API 키 인증에 실패했습니다. |
| **500** | 번역 서버 연결 오류 | AI 엔진과 통신 중 오류가 발생했습니다. |
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/translate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"안녕하세요, 만나서 반갑습니다.","target_lang":"en"}'