Translate

공통 설정

인증키 발급

인증 토근 발급받기 위한 계정 생성 이름, 이메일, 패스워드 입력 후 계정을 생성 해야만 정상적으로 사용이 가능합니다.

토큰 발급을 위한 로그인

이메일 / 패스워드 입력 토큰 값 발급 후 인증 통해 정상적으로 API 를 이용 하실 수 있습니다.

발급 토큰 유효

토큰은 발급 1시간 후 자동 파기 됩니다. 재발급 받으셔야 정상 이용 가능합니다.

번역 요청 (번역기 선택)

API URL

Method	Request URI
POST	/api/v1/translate

요청 헤더

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값]
Content-Type	application/json

요청 파라미터

파라미터 이름	타입	설명	기본값	필수 여부
select	string	번역기 선택 NAVER, DeepL, OpenAI	N	Y
source	string	원본 언어의 언어코드 auto 설정시, 자동 언어 감지 ko, en, ja, zh-CN, auto	N	Y
target	string	목적 언어의 언어코드 en, ko, ja, zh-CN 등	N	Y
text	string	번역할 텍스트	N	Y
honorific	string	높임말 여부 아래의 형식으로만 번역 가능 (원본언어 => 목적언어) en ⇒ ko ja ⇒ ko zh-CN ⇒ ko ko ⇒ ja en ⇒ ja zh-CN ⇒ ja	False	Y

번역하지 않아야 할 텍스트의 경우, html span tag를 사용하여 해당 텍스트 지정 가능.

응답 바디

필드 이름	타입	설명
srcLangType	String	원본 언어 코드
tarLangType	String	목적 언어 코드
translatedText	String	번역 된 문장

번역 요청 (DeepL)

API URL

Method	Request URI
POST	/api/vi/translate/DeepL

요청 헤더

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값]
Content-Type	application/json

요청 파라미터

파라미터 이름	타입	설명	기본값	필수 여부
source	string	원본 언어의 언어코드 KO, BG, CS, DA, DE 등	N	Y
target	string	목적 언어의 언어코드 EN-US, BG, CS, DA, DE 등	N	Y
text	string	번역할 텍스트	N	Y

파라미터 이름

타입

설명

기본값

필수 여부

source

string

원본 언어의 언어코드

KO, BG, CS, DA, DE 등

target

string

목적 언어의 언어코드

EN-US, BG, CS, DA, DE 등

text

string

번역할 텍스트

응답 바디

필드 이름	타입	설명
srcLangType	String	원본 언어 코드
tarLangType	String	목적 언어 코드
translatedText	String	번역 된 문장

번역 요청 (NAVER)

API URL

Method	Request URI
POST	/api/v1/translate/NAVER

요청 헤더

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값]
Content-Type	application/json

요청 파라미터

파라미터 이름	타입	설명	기본값	필수 여부
source	string	원본 언어의 언어코드 auto 설정시, 자동 언어 감지 ko, en, ja, zh-CN, auto	N	Y
target	string	목적 언어의 언어코드 en, ko, ja, zh-CN 등	N	Y
text	string	번역할 텍스트	N	Y
honorific	string	높임말 여부 아래의 형식으로만 번역 가능 (원본언어 => 목적언어) en ⇒ ko ja ⇒ ko zh-CN ⇒ ko ko ⇒ ja en ⇒ ja zh-CN ⇒ ja	False	Y

응답 바디

필드 이름	타입	설명
srcLangType	String	원본 언어 코드
tarLangType	String	목적 언어 코드
translatedText	String	번역 된 문장

음성 파일 텍스트 분리

API URL

Method	Request URI
POST	/api/v1/upload

요청 헤더

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer [토큰값]
Content-Type	application/json

요청 파라미터

파라미터 이름	타입	설명	기본값	필수 여부
language	string	언어 선택 ko-KR, en-US, enko, ja, zh-cn, zh-tw	N	Y
format	string	포맷 형식 JSON, SRT, SMI	N	Y

파라미터 이름

타입

설명

기본값

필수 여부

language

string

언어 선택

ko-KR, en-US, enko, ja, zh-cn, zh-tw

format

string

포맷 형식

JSON, SRT, SMI

응답 바디

필드 이름	타입	설명
srcLangType	String	원본 언어 코드
tarLangType	String	목적 언어 코드
translatedText	String	번역 된 문장

오류 코드

# JSON
 
{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

공통 오류

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) 등 request 오류
401	200	Authentication Failed	인증실패
401	210	Permission Denied	권한없음
404	300	Not Found Exception	권한없음
429	400	Quota Exceeded	Quota 초과
429	410	Throttle Limited	Rate 초과
429	420	Rate Limited	Rate 초과
413	430	Request Entity Too Large	content-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결오류
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 오류

Swagger 문서

Swagger 바로가기