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 호출을 위한 키로, 신청 후 직접 드롭다운에서 선택할 수 있습니다.
input: 번역할 내용입니다.extension=md일 때는 문자열을,extension=json일 때는 JSON 객체를 전달합니다.locale: 사용자 정의 번역 언어입니다.extension: 입력 내용 형식으로, 선택적으로md또는json을 사용할 수 있습니다.model: 번역에 사용되는 대모델로, 기본값은 gpt-3.5입니다.
extension은 input 유형과 일치해야 합니다; 문자열은 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: 내부 서버 오류, 서버에서 문제가 발생했습니다.

