TokenLab

텍스트

번역 생성

텍스트를 대상 언어로 번역합니다

POST
/v1/translations

개요

텍스트 간 번역에는 /v1/translations를 사용합니다.

이 엔드포인트는 오디오 파일을 입력받아 항상 영어 텍스트로 출력하는 오디오 번역과 다릅니다.

Models API를 사용하여 현재 텍스트 번역 모델을 확인하세요:

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

그런 다음 선택한 모델을 /v1/translations에 명시적으로 전달합니다.

recommended_for=translation은 텍스트 번역(POST /v1/translations)에만 적용됩니다. 오디오 번역에는 적용되지 않습니다.

요청 본문

modelstring필수

/v1/models?recommended_for=translation에서 반환된 번역 모델 ID입니다.

textstring필수

번역할 원본 텍스트입니다. 입력 길이 제한은 모델에 따라 다르며, GET /v1/models/{model}의 max_input_tokens를 확인하세요.

target_languagestring필수

모델 지원 여부에 따른 대상 언어 코드 또는 언어 이름입니다.

source_languagestring

원본 언어에 대한 선택적 힌트입니다.

mime_typestring기본값: text/plain

원본 텍스트 형식: text/plain 또는 text/html. 모델 상세 정보에 mime_type이 나열되어 있는 경우에만 전송하세요.

userstring

오남용 모니터링 및 요청 추적을 위한 선택적 최종 사용자 식별자입니다. 모델 상세 정보에 user가 나열되어 있는 경우에만 전송하세요.

응답

textstring

번역된 텍스트입니다.

modelstring

번역을 생성한 모델입니다.

source_languagestring | null

모델이 감지했거나 수락한 원본 언어입니다.

target_languagestring

요청에 사용된 대상 언어입니다.

요청

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "你好,欢迎使用 TokenLab。",
    "target_language": "en"
  }'

응답

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "zh",
  "target_language": "en"
}

오류

상태코드원인
400invalid_requestmodel, text 또는 target_language가 누락되었거나 비어 있음, 또는 mime_type이 두 값 중 하나가 아님. param에 해당 필드가 지정됨
400unsupported_endpoint이 엔드포인트에 공개되지 않은 모델임

기타 상태는 API 오류 처리를 참고하여 처리하세요.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json