번역

다양한 언어의 번역을 담당하는 API입니다. 현재 입력된 텍스트를 기반으로 번역 텍스트 결과를 전달해주는 기능을 제공합니다. 현재 지원되는 언어로 영어, 일본어, 중국어와 한국어 간의 상호 번역을 지원하고 있습니다.

현재 제공되는 API는 다음과 같습니다.

공통사항

API 호출시 공통적으로 다음과 같은 사항을 준수해야 합니다.

  • 서버에서 호출하는 경우 REST API 키를 사용해 호출합니다.

문장번역

[Request]

GET /v1/translation/translate HTTP/1.1
Host: kapi.kakao.com
Authorization: KakaoAK {app_key}

또는,

POST /v1/translation/translate HTTP/1.1
Host: kapi.kakao.com
Authorization: KakaoAK {app_key}

app_key를 Authroization 헤더에 담아 GET/POST로 요청합니다. 요청에 필요한 파라미터는 다음과 같습니다.

설명 타입 필수여부
query 번역 대상 문장(사전선택에 따라서 영어 또는 한글) String O
src_lang 번역 대상 언어 (kr/en/jp/cn/vi/id) String O
target_lang 번역 결과 언어 (kr/en/jp/cn/vi/id) String O
언어 표기
한국어 kr
영어 en
일본어 jp
중국어 cn
베트남어 vi
인도네시아어 id

한국어를 제외한 타언어간의 번역은 제공되지 않습니다. 즉, 한국어에서 타언어로의 번역, 혹은 타언어에서 한국어로의 번역만 지원합니다.

예를 들면,

curl -v --get 'https://kapi.kakao.com/v1/translation/translate' \
    -d 'src_lang=kr' \
    -d 'target_lang=en' \
    --data-urlencod 'query=지난해 3월 오픈한 카카오톡 주문하기는 현재까지 약 250만명의 회원을 확보했으며, 주문 가능한 프랜차이즈 브랜드는 38개, 가맹점수는 약 1만 5천여곳에 달한다. 전 국민에게 친숙한 카카오톡 UI를 활용하기 때문에 남녀노소 누구나 쉽게 이용할 수 있으며, 별도의 앱을 설치할 필요 없이 카카오톡 내에서 모든 과정이 이뤄지는 것이 특징이다. 지난해 9월 업계 최초로 날짜와 시간을 예약한 뒤 설정한 매장에서 주문 음식을 찾아가는 ‘픽업’ 기능을 도입했고, 올해 1월 스마트스피커 ‘카카오미니’에서 음성을 통해 주문 가능한 메뉴를 안내받을 수 있도록 서비스를 연동하며 차별화를 꾀했다.

중소사업자들이 카카오톡 주문하기에 입점하게 되면 4,300만 카카오톡 이용자들과의 접점을 확보하고, 간편한 주문 과정으로 만족도를 높일 수 있게 된다. 카카오톡 메시지를 통해 신메뉴 출시, 프로모션 등의 소식을 전달할 수 있고, 일대일 채팅 기능을 적용하면 고객과 직접 상담도 가능하다.' \
    -H 'Authorization: KakaoAK KKKKKKKKKKKKKKKKKKKKKKKKKKKK'

[Response]

요청이 성공하면 응답 바디에 JSON 객체로 아래 값을 포함합니다.

설명 타입
translated_text 번역결과 리스트. 문단 단위의 리스트가 문단 순서대로 정렬 String array

예를 들면,

HTTP/1.1 200 OK
{
    "translated_text": [
        [
            "KakaoTalk orders, which opened in March last year, have secured about 2.5 million members so far, 38 franchise brands that can be ordered, and about 15,000 franchisees.",
            "Because it utilizes KakaoTalk UI, which is familiar to all citizens, it is easy to use by both men and women, and it is characterized by all the processes in KakaoTalk without having to install a separate app.",
            "In September last year, the company introduced the 'pickup' function, which was the first in the industry to book dates and times, and set up a store to visit order food. In January of this year, Smart speaker 'Kakao Mini'",
            "You can send news such as new menu release, promotion through KakaoTalk message, and you can consult with customers directly by applying one-on-one chat function."
        ]
    ]
}

Last Modified : 2018-07-26