페이지 이동경로
  • 문서>
  • 번역>
  • 개발 가이드

번역

개발 가이드

이 문서는 카카오 번역 API 사용 방법을 설명합니다.

이 문서에 포함된 기능은 [도구] > [REST API 테스트]를 통해 사용해 볼 수 있습니다.

문장 번역하기

문장 번역요청한 문장을 다양한 언어로 번역하는 API로써 입력된 텍스트를 기반으로 번역 텍스트 결과를 전달합니다. 한국어와 타언어간 번역외에도 타언어간 번역도 지원됩니다.

REST API 키를 Authorization 헤더에 담아 GET 또는 POST로 요청합니다. 요청이 성공하면 JSON 객체로 번역 결과 목록을 전달합니다.

Request
URL
GET /v2/translation/translate HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}
POST /v2/translation/translate HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}
Content-type: application/x-www-form-urlencoded
Parameter
Name Type Description Required
query String 번역 대상 문장
최대 5,000자
O
src_lang String 번역 대상 언어 O
target_lang String 번역 결과 언어 O
Response
Key
Name Type Description
translated_text List of String[] 번역결과 리스트, 문단 단위의 리스트가 문단 순서대로 정렬
Sample
Request: GET 방식
curl -v --get "https://dapi.kakao.com/v2/translation/translate" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -d "src_lang=kr" \
    -d "target_lang=en" \
    --data-urlencode "query=지난해 3월 오픈한 카카오톡 주문하기는 현재까지 약 250만명의 회원을 확보했으며, 주문 가능한 프랜차이즈 브랜드는 38개, 가맹점수는 약 1만 5천여곳에 달한다. 전 국민에게 친숙한 카카오톡 UI를 활용하기 때문에 남녀노소 누구나 쉽게 이용할 수 있으며, 별도의 앱을 설치할 필요 없이 카카오톡 내에서 모든 과정이 이뤄지는 것이 특징이다. 지난해 9월 업계 최초로 날짜와 시간을 예약한 뒤 설정한 매장에서 주문 음식을 찾아가는 ‘픽업’ 기능을 도입했고, 올해 1월 스마트스피커 ‘카카오미니’에서 음성을 통해 주문 가능한 메뉴를 안내받을 수 있도록 서비스를 연동하며 차별화를 꾀했다. 중소사업자들이 카카오톡 주문하기에 입점하게 되면 4,300만 카카오톡 이용자들과의 접점을 확보하고, 간편한 주문 과정으로 만족도를 높일 수 있게 된다. 카카오톡 메시지를 통해 신메뉴 출시, 프로모션 등의 소식을 전달할 수 있고, 일대일 채팅 기능을 적용하면 고객과 직접 상담도 가능하다." 
Request: POST 방식
curl -v -X POST "https://dapi.kakao.com/v2/translation/translate" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    -d "src_lang=kr" \
    -d "target_lang=en" \
    --data-urlencode "query=지난해 3월 오픈한 카카오톡 주문하기는 현재까지 약 250만명의 회원을 확보했으며, 주문 가능한 프랜차이즈 브랜드는 38개, 가맹점수는 약 1만 5천여곳에 달한다. 전 국민에게 친숙한 카카오톡 UI를 활용하기 때문에 남녀노소 누구나 쉽게 이용할 수 있으며, 별도의 앱을 설치할 필요 없이 카카오톡 내에서 모든 과정이 이뤄지는 것이 특징이다. 지난해 9월 업계 최초로 날짜와 시간을 예약한 뒤 설정한 매장에서 주문 음식을 찾아가는 ‘픽업’ 기능을 도입했고, 올해 1월 스마트스피커 ‘카카오미니’에서 음성을 통해 주문 가능한 메뉴를 안내받을 수 있도록 서비스를 연동하며 차별화를 꾀했다. 중소사업자들이 카카오톡 주문하기에 입점하게 되면 4,300만 카카오톡 이용자들과의 접점을 확보하고, 간편한 주문 과정으로 만족도를 높일 수 있게 된다. 카카오톡 메시지를 통해 신메뉴 출시, 프로모션 등의 소식을 전달할 수 있고, 일대일 채팅 기능을 적용하면 고객과 직접 상담도 가능하다." 
Response
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."
        ]
    ]
}

언어 감지하기

입력된 텍스트의 언어를 감지하는 API입니다.

REST API 키를 Authorization 헤더에 담아 GET 또는 POST로 요청합니다. 요청이 성공하면 JSON 객체로 감지된 언어와 결과의 신뢰도를 전달합니다.

Request

URL

GET /v3/translation/language/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}
POST /v3/translation/language/detect HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {REST_API_KEY}
Content-type: application/x-www-form-urlencoded
Parameter
Name Type Description Required
query String 언어의 종류를 판단할 대상 문장
최대 5,000자
O
Response
Key
Name Type Description
language_info List of LanguageInfo 언어 감지 결과 리스트, 신뢰도가 높은 순서대로 정렬, 최대 3개의 결과 반환
LanguageInfo
Name Type Description
code String 감지된 언어 코드
name String 감지된 언어
confidence Float 감지된 결과의 신뢰도, 0 ~ 1.0 사이의 값
Sample
Request: GET 방식
curl -v --get "https://dapi.kakao.com/v3/translation/language/detect" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "query=Kakao Enterprise provides the AI platform essentials to enterprises by evolving Kakao’s AI technology and service expertise into innovative, ready-to-deploy business services." 
Request: POST 방식
curl -v -X POST "https://dapi.kakao.com/v3/translation/language/detect" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Authorization: KakaoAK {REST_API_KEY}" \
    --data-urlencode "query=Kakao Enterprise provides the AI platform essentials to enterprises by evolving Kakao’s AI technology and service expertise into innovative, ready-to-deploy business services." 
Response
HTTP/1.1 200 OK
{
    "language_info": [
        {
            "code": "en",
            "name": "English",
            "confidence": 0.99706
        },
        {
            "code": "de",
            "name": "German",
            "confidence": 0.00253
        },
        {
            "code": "es",
            "name": "Spanish",
            "confidence": 0.00019
        }
    ]
}
Response: 지원되지 않는 언어인 경우
HTTP/1.1 200 OK
{
    "language_info": [
        {
            "code": "N/A",
            "name": "Unsupported language detected.",
            "confidence": 0
        }
    ]
}

더보기