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

​
신청 절차

Localization Translate API를 사용하려면 먼저 신청 페이지 Localization Translate API에서 해당 서비스를 신청해야 합니다. 페이지에 들어가면 “Acquire” 버튼을 클릭합니다. 아래와 같이 표시됩니다: 신청 페이지 로그인 또는 등록이 되어 있지 않으면 자동으로 로그인 페이지로 이동하여 등록 및 로그인을 요청합니다. 로그인 및 등록 후에는 자동으로 현재 페이지로 돌아옵니다. 첫 신청 시 무료 한도가 제공되어 이 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: 업로드할 번역이 필요한 텍스트.
  • locale: 사용자 정의 번역 언어.
  • extension: 사용자 정의 번역 결과의 표시 형식.
  • model: 번역에 사용되는 대모델로, 기본값은 gpt-3.5입니다.
설정은 아래와 같이 표시됩니다:

​
코드 예시

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

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

​
CURL

curl -X POST 'https://api.acedata.cloud/localization/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
  "locale": "zh-CN",
  "extension": "md"
}'

​
Python

import requests

url = "https://api.acedata.cloud/localization/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "input": "# Title 1\n\nThis is a paragraph.\n\n## Title 2\n\nThis is another paragraph.",
    "locale": "zh-CN",
    "extension": "md"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
응답 예시

요청이 성공하면 API는 이 번역 작업의 결과 정보를 반환합니다. 예를 들어: 
{
  "data": "# 제목 1\n\n이것은 하나의 단락입니다.\n\n## 제목 2\n\n이것은 또 다른 단락입니다.",
  "usage": {
    "prompt_tokens": 172,
    "completion_tokens": 25
  },
  "model": "gpt-3.5-turbo-16k",
  "locale": "zh-CN"
}
결과에서 data 필드가 있으며, 그 안에 번역된 중국어가 포함되어 있고, markdown 형식으로 반환됩니다. 다른 정보는 다음과 같습니다:
  • data: 이 번역 작업의 결과.
  • model: 이 번역 작업에 사용된 대형 언어 모델.
  • locale: 이 번역 작업의 번역 언어 유형.

​
오류 처리

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

​
오류 응답 예시

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
결론

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