Skip to main content
Localization Translate API의 주요 기능은 입력된 번역할 텍스트를 통해 번역된 텍스트를 얻는 것이며, 번역된 언어는 사용자 정의할 수 있고, 번역 결과는 json, markdown 두 가지 주요 방법으로 출력할 수 있습니다. 본 문서는 Translate API의 대결 설명을 자세히 소개하여 귀하가 이 API의 강력한 기능을 쉽게 통합하고 충분히 활용할 수 있도록 돕습니다. Translate API를 통해 입력된 텍스트를 특정 언어로 번역하고, 번역 결과를 특정 방식으로 출력할 수 있습니다.

신청 절차

Localization Translate API를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API Token을 받아 두십시오. 로그인 또는 등록이 되어 있지 않으면 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 초대합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다. 하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스에 대해 별도로 신청할 필요가 없습니다. 처음 신청 시 무료 할당량이 제공되어 무료로 체험할 수 있습니다; 할당량이 부족할 경우 콘솔에서 일반 잔액을 충전할 수 있습니다.
📘 전체 문서: Localization Translate API →

요청 예시

영어 입력을 예로 들어 이 API를 사용하는 방법을 시연합니다. 영어 설명이 # Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.라고 가정하고, 영어 설명을 업로드하고 중국어 번역 결과를 얻는 방법을 시연하며, markdown 형식으로 보여줍니다.

요청 헤더 및 요청 본문 설정

Request Headers에는 다음이 포함됩니다:
  • accept: JSON 형식의 응답 결과를 수신하도록 지정하며, 여기서는 application/json으로 입력합니다.
  • authorization: API 호출을 위한 키로, 신청 후 직접 드롭다운에서 선택할 수 있습니다.
Request Body에는 다음이 포함됩니다:
  • input: 번역할 내용입니다. extension=md일 때는 문자열을, extension=json일 때는 JSON 객체를 전달합니다.
  • locale: 사용자 정의 번역 언어입니다.
  • extension: 입력 내용 형식으로, 선택적으로 md 또는 json을 사용할 수 있습니다.
  • model: 번역에 사용되는 대모델로, 기본값은 gpt-3.5입니다.
extensioninput 유형과 일치해야 합니다; 문자열은 json을 사용할 수 없고, JSON 객체는 md를 사용할 수 없습니다. 설정은 아래 그림과 같이 합니다:

코드 예시

페이지 오른쪽에서 다양한 언어의 코드가 자동으로 생성된 것을 확인할 수 있습니다, 아래 그림과 같이:

일부 코드 예시는 다음과 같습니다:

CURL

Python

응답 예시

요청이 성공하면 API는 이 번역 작업의 결과 정보를 반환합니다. 예를 들어:
결과에서 data 필드가 있으며, 그 안에 번역된 중국어가 포함되어 있고, markdown 형식으로 반환됩니다. 기타 정보는 다음과 같습니다:
  • data, 이 번역 작업의 결과입니다.
  • model, 이 번역 작업에 사용된 대언어 모델입니다.
  • locale, 이 번역 작업의 번역 언어 유형입니다.

오류 처리

API를 호출할 때 오류가 발생하면 API는 해당 오류 코드와 정보를 반환합니다. 예를 들어:
  • 400 token_mismatched: 잘못된 요청, 누락되거나 잘못된 매개변수 때문일 수 있습니다.
  • 400 api_not_implemented: 잘못된 요청, 누락되거나 잘못된 매개변수 때문일 수 있습니다.
  • 401 invalid_token: 인증되지 않음, 잘못되었거나 누락된 인증 토큰입니다.
  • 429 too_many_requests: 너무 많은 요청, 비율 제한을 초과했습니다.
  • 500 api_error: 내부 서버 오류, 서버에서 문제가 발생했습니다.

오류 응답 예시

결론

본 문서를 통해 Localization Translate API를 사용하여 입력된 텍스트를 특정 언어로 쉽게 번역하고, 번역 결과를 특정 방식으로 출력하는 방법을 이해하셨습니다. 본 문서가 귀하가 이 API를 더 잘 통합하고 사용할 수 있도록 도와주기를 바랍니다. 질문이 있으시면 언제든지 기술 지원 팀에 문의해 주십시오.