오디오 및 실시간
트랜스크립션 생성
오디오를 입력 언어로 텍스트 변환합니다
현재 트랜스크립션 모델 목록을 가져오려면 GET /v1/models?recommended_for=stt를 사용하세요.
요청 본문
트랜스크립션은 텍스트 변환 결과를 즉시 반환하거나 HTTP 200, id, status와 함께 비동기 작업을 수락할 수 있습니다. 수락된 작업의 경우 반환된 id를 사용하여 GET /v1/tasks/{id}를 폴링하세요. 더 긴 동기 오디오의 경우 클라이언트 타임아웃을 최소 120s 이상으로 설정하세요.
텍스트로 변환할 오디오 파일입니다. 지원되는 형식: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. 최대 파일 크기: 25 MB.
트랜스크립션 모델 ID입니다(예: whisper-large-v3 또는 qwen3-asr-flash). 현재 선택 가능한 모델은 GET /v1/models?recommended_for=stt로 확인할 수 있습니다. 기본 모델은 없습니다.
ISO-639-1 형식의 오디오 언어입니다(예: en, zh, ja).
qwen3-asr-flash와 같이 이 매개변수를 지원하는 모델의 경우 모델의 스타일을 유도하거나 이전 세그먼트를 이어가기 위한 선택적 텍스트입니다.
json출력 형식입니다. 모델마다 지원 여부가 다릅니다. 모든 모델이 json을 수용하며, 일부 모델은 text 또는 verbose_json도 지원합니다. 다른 값을 전송하기 전에 선택한 모델의 세부 정보를 확인하세요. text는 JSON 객체 대신 원시 텍스트를 반환합니다.
0에서 1 사이의 샘플링 온도로, 이 매개변수를 지원하는 모델에만 적용됩니다.
이 매개변수를 지원하는 모델에만 해당하는 word 및/또는 segment입니다. 일부 모델은 타임스탬프를 위해 response_format=verbose_json이 필요합니다. multipart 요청에서는 여러 값을 지정하기 위해 timestamp_granularities[]를 반복하여 전달하세요.
응답
아래 필드는 JSON 트랜스크립션 또는 번역 응답을 설명합니다. text, srt, vtt는 JSON 객체 대신 원시 텍스트 또는 자막을 반환합니다. 추가 필드는 모델 및 출력 형식에 따라 달라집니다.
변환된 텍스트입니다.
verbose_json의 경우:
반환 시 작업 이름입니다(예: transcribe).
감지된 언어입니다.
초 단위의 오디오 재생 시간입니다.
타임스탬프가 포함된 트랜스크립션 세그먼트입니다.
단어 수준 타임스탬프입니다(요청된 경우).
수락된 비동기 트랜스크립션 작업은 텍스트 변환 결과 대신 다음 필드를 반환합니다. GET /v1/tasks/{id}를 폴링하세요. 완료된 작업은 text를 반환하며, 지원되는 경우 duration, segments, words도 반환합니다.
작업 ID입니다.
제공되는 경우 비동기 작업 식별자 별칭입니다.
작업 상태: pending, processing, completed, 또는 failed.
이 작업의 상태 URL입니다. id와 함께 GET /v1/tasks/{id}를 폴링하세요.
요청
curl -X POST "https://api.tokenlab.sh/v1/audio/transcriptions" \
-H "Authorization: Bearer sk-your-api-key" \
-F file="@audio.mp3" \
-F model="whisper-large-v3" \
-F language="en"응답
{
"text": "Hello, this is a test of the transcription API."
}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
multipart/form-data
응답
application/json
application/json
application/json
application/json
application/json
application/json