텍스트
번역 생성
텍스트를 대상 언어로 번역합니다
개요
텍스트 간 번역에는 /v1/translations를 사용합니다.
이 엔드포인트는 오디오 파일을 입력받아 항상 영어 텍스트로 출력하는 오디오 번역과 다릅니다.
Models API를 사용하여 현재 텍스트 번역 모델을 확인하세요:
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"그런 다음 선택한 모델을 /v1/translations에 명시적으로 전달합니다.
recommended_for=translation은 텍스트 번역(POST /v1/translations)에만 적용됩니다. 오디오 번역에는 적용되지 않습니다.
요청 본문
/v1/models?recommended_for=translation에서 반환된 번역 모델 ID입니다.
번역할 원본 텍스트입니다. 입력 길이 제한은 모델에 따라 다르며, GET /v1/models/{model}의 max_input_tokens를 확인하세요.
모델 지원 여부에 따른 대상 언어 코드 또는 언어 이름입니다.
원본 언어에 대한 선택적 힌트입니다.
text/plain원본 텍스트 형식: text/plain 또는 text/html. 모델 상세 정보에 mime_type이 나열되어 있는 경우에만 전송하세요.
오남용 모니터링 및 요청 추적을 위한 선택적 최종 사용자 식별자입니다. 모델 상세 정보에 user가 나열되어 있는 경우에만 전송하세요.
응답
번역된 텍스트입니다.
번역을 생성한 모델입니다.
모델이 감지했거나 수락한 원본 언어입니다.
요청에 사용된 대상 언어입니다.
요청
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"
}'응답
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}오류
| 상태 | 코드 | 원인 |
|---|---|---|
400 | invalid_request | model, text 또는 target_language가 누락되었거나 비어 있음, 또는 mime_type이 두 값 중 하나가 아님. param에 해당 필드가 지정됨 |
400 | unsupported_endpoint | 이 엔드포인트에 공개되지 않은 모델임 |
기타 상태는 API 오류 처리를 참고하여 처리하세요.
인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
application/json
응답
application/json
application/json
application/json
application/json
application/json
application/json