TokenLab

텍스트

번역 생성

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

POST
/v1/translations

개요

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

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

에이전트 워크플로우에서는 먼저 현재 추천 번역 모델을 조회하세요:

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필수

번역할 원문 텍스트입니다.

target_languagestring필수

모델 지원 방식에 따라 대상 언어 코드 또는 언어 이름입니다.

source_languagestring

선택적 원문 언어 힌트입니다.

mime_typestring기본값: text/plain

원문 형식입니다. 지원 값: text/plain, text/html.

userstring

남용 모니터링과 요청 추적을 위한 선택적 최종 사용자 식별자입니다.

응답

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": "ko",
  "target_language": "en"
}

인증

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