TokenLab

오디오 및 실시간

번역 생성

오디오를 영어 텍스트로 번역합니다

POST
/v1/audio/translations

개요

지원되는 모든 언어의 오디오를 영어 텍스트로 번역합니다. 전사(transcription)와 달리 이 엔드포인트는 입력 언어에 관계없이 항상 영어 텍스트를 출력합니다.

이 엔드포인트는 오디오를 영어로 번역합니다. language를 전송하지 마세요. 오디오 번역에서는 지원되지 않으며 unsupported_parameter를 반환할 수 있습니다. 텍스트 번역의 경우 POST /v1/translations를 사용하세요. recommended_for=translation은 해당 텍스트 API를 나타냅니다.

요청 본문

처리가 완료되면 번역 결과가 반환됩니다. 길이가 긴 오디오의 경우 HTTP 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.

filefile필수

번역할 오디오 파일입니다. 지원되는 형식: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. 최대 파일 크기는 25 MB입니다.

modelstring필수

현재 POST /v1/audio/translations 지원을 선언한 공개 모델이 없습니다. 기본값이나 복사 가능한 모델 ID가 제공되지 않습니다.

promptstring

모델의 스타일을 유도하거나 이전 세그먼트를 이어가기 위한 선택적 텍스트입니다. 영어로 작성해야 합니다.

response_formatstring기본값: json

출력 형식입니다. 허용되는 값은 모델에 따라 다르므로 모델 세부 정보를 확인하세요. text는 JSON 객체 대신 원시 텍스트를 반환합니다.

temperaturenumber

0에서 1 사이의 샘플링 온도로, 이 파라미터를 지원하는 모델에만 적용됩니다.

응답

아래 필드는 JSON 전사 또는 번역 응답에 대해 설명합니다. text, srt, vtt는 JSON 객체 대신 원시 텍스트나 자막을 반환합니다. 추가 필드는 모델 및 출력 형식에 따라 달라집니다.

textstring

영어로 번역된 텍스트입니다.

verbose_json 형식의 경우 응답에 다음 항목도 포함됩니다:

languagestring

제공된 경우 응답에 보고되는 언어 레이블입니다.

durationnumber

입력 오디오의 길이(초 단위)입니다.

segmentsarray

타임스탬프가 포함된 번역 텍스트 세그먼트입니다.

요청

curl -X POST "https://api.tokenlab.sh/v1/audio/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-model-id" \
  -F "file=@german_audio.mp3"

응답

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you from?"
}

번역 vs 전사

기능번역전사
출력 언어항상 영어입력과 동일
사용 사례외국어 오디오를 영어로 변환원본 언어 유지
Language 파라미터해당 없음선택적 힌트

인증

BearerAuth
AuthorizationBearer <token>

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

위치: header

헤더

X-TokenLab-Delivery-Policy?string

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

허용 값

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

요청 본문

multipart/form-data

응답

application/json

application/json

application/json

application/json

application/json

application/json