v1

latestOpenAPI 3.0.12026-07-26101834.1 KB

Speech to Text

Transcribe or translate audio using Whisper Large V2

Process audio files for transcription or translation with advanced options

post/model/v2/infer/whisper

Request body

audio_datastring required

TEXT FIELD: This is a string field (not a file upload). Provide the audio as a base64-encoded string. First convert your audio file (.mp3, .wav, .flac) to base64, then paste the resulting string here.

languagestring required

Language code (e.g. 'en' for English)

task'transcribe' | 'translate' required

Task type - transcribe in source language or translate to English

initial_promptstring

Optional starting text prompt for context

beam_sizeinteger

Number of parallel sequences evaluated

best_ofinteger

Number of best sequences considered

word_timestamps0 | 1

Include word-level timestamps (0=false, 1=true)

diarization0 | 1

Enable speaker diarization (0=false, 1=true)

vad_filter0 | 1

Enable voice activity detection filter (0=false, 1=true)

without_timestamps0 | 1

Exclude timestamps from output (0=false, 1=true)

streaming0 | 1

Enable streaming output (0=false, 1=true)

min_speakersnumber

Minimum number of speakers to detect

max_speakersnumber

Maximum number of speakers to detect

batch_sizeinteger

Number of audio samples processed in one batch

length_penaltynumber

Penalty for longer sequences

patiencenumber

Beam search patience factor

min_duration_offnumber

Minimum duration of silence for a break

min_duration_onnumber

Minimum duration for speech detection

vad_onsetnumber

Voice activity detection onset threshold

vad_offsetnumber

Voice activity detection offset threshold

pad_offsetnumber

Additional padding at segment end

pad_onsetnumber

Additional padding at segment start

max_durationnumber

Maximum duration to process

Example request

{
  "language": "en",
  "task": "transcribe"
}

Response

Successful transcription

transcriptionstring[]

Array of transcribed text segments

request_timenumber

Total processing time in seconds

languagestring

Detected or specified language