번역할 이미지를 드래그하거나 붙여 넣어 보세요.
번역할 문서를 드래그하여 넣어 보세요.
DOCX · PPTX · XLSX · HWPX · PDF · TXT · MD · CSV
텍스트를 입력하면 언어 감지 후 번역합니다. source_lang을 지정하면 감지를 건너뜁니다. 최대 2,000자.
POST /v1/translate/text
curl -X POST https://api.clovastudio.go.kr/v1/translate/text \
-H "Content-Type: application/json" \
-d '{
"text": "안녕하세요",
"source_lang": "ko",
"target_lang": "en"
}'
{
"status": { "code": "20000", "message": "OK" },
"result": {
"translated_text": "Hello.",
"source_lang": "ko",
"target_lang": "en"
},
"usage": {
"prompt_tokens": 12,
"completion_tokens": 4,
"total_tokens": 16
}
}
POST /v1/translate/detect
curl -X POST https://api.clovastudio.go.kr/v1/translate/detect \
-H "Content-Type: application/json" \
-d '{ "text": "안녕하세요" }'
# 응답
{ "status": {...}, "result": { "language": "ko" } }
GET /v1/translate/languages
curl https://api.clovastudio.go.kr/v1/translate/languages
# 응답
{
"status": {...},
"result": {
"languages": [
{ "code": "en" },
{ "code": "ko" },
...
]
}
}
이미지를 base64 또는 URL로 전달하면 멀티모달 모델이 이미지 내 텍스트를 OCR하여 번역합니다. source_lang 미입력 시 이미지에서 언어를 자동 감지합니다. URL 입력 시 내부 네트워크 SSRF 검증이 수행됩니다.
POST /v1/translate/image # multipart/form-data 파일 업로드
curl -X POST https://api.clovastudio.go.kr/v1/translate/image \ -F "file=@image.jpg" \ -F "target_lang=en" \ -F "source_lang=ko"
{
"status": { "code": "20000", "message": "OK" },
"result": {
"translated_text": "Hello, World!",
"source_lang": "ko",
"target_lang": "en"
},
"usage": {
"prompt_tokens": 0,
"completion_tokens": 8,
"total_tokens": 8
}
}
DOCX·PPTX·XLSX·HWPX·TXT·MD·CSV 문서를 업로드하면 번역된 파일을 직접 반환합니다. 최대 50MB.
POST /v1/translate/document # 동기 — 번역 완료 후 파일 즉시 반환
curl -X POST \ "https://api.clovastudio.go.kr/v1/translate/document?target_lang=en&source_lang=ko" \ -F "file=@report.docx" \ -o report_translated_en.docx
# 번역된 파일이 직접 반환됩니다 Content-Type: application/vnd.openxmlformats-officedocument... Content-Disposition: attachment; filename*=UTF-8''report_translated_en.docx X-Partial-Failure: true # 일부 단락 번역 실패 시에만 포함
target_lang string 필수 목표 언어 코드 (ISO 639-1). 예: en, ja, zh source_lang string 선택 출발 언어 코드. 미입력 시 자동 감지
번역할 이미지를 드래그하거나 붙여 넣어 보세요.
번역할 문서를 드래그하여 넣어 보세요.