Skip to main content
POST
/
audio
/
transcriptions

# Download audio file
curl -L -o "audio.flac" "https://tinyurl.com/4997djsh"

# Make request
curl -X POST "https://audio-prod.api.fireworks.ai/v1/audio/transcriptions" \
-H "Authorization: <FIREWORKS_API_KEY>" \
-F "[email protected]"

Try notebook

Send a sample audio to get a transcription.

​
Headers

​
Authorization
string
required
Your Fireworks API key, e.g. Authorization=API_KEY.

​
Request

(multi-part form)
​
file
file | string
required
The input audio file to transcribe or an URL to the public audio file.Max audio file size is 1 GB, there is no limit for audio duration. Common file formats such as mp3, flac, and wav are supported. Note that the audio will be resampled to 16kHz, downmixed to mono, and reformatted to 16-bit signed little-endian format before transcription. Pre-converting the file before sending it to the API can improve runtime performance.
​
model
string
default:"whisper-v3"
String name of the ASR model to use. Can be one of whisper-v3 or whisper-v3-turbo. Please use the following serverless endpoints:
​
vad_model
string
default:"silero"
String name of the voice activity detection (VAD) model to use. Can be one of silero, or whisperx-pyannet.
​
alignment_model
string
default:"mms_fa"
String name of the alignment model to use. Currently supported:
  • mms_fa optimal accuracy for multilingual speech.
  • tdnn_ffn optimal accuracy for English-only speech.
  • gentle best accuracy for English-only speech (requires a dedicated endpoint, contact us at [email protected]).
​
language
string | null
The target language for transcription. See the Supported Languages section below for a complete list of available languages.
​
prompt
string | null
The input prompt that the model will use when generating the transcription. Can be used to specify custom words or specify the style of the transcription. E.g. Um, here's, uh, what was recorded. will make the model to include the filler words into the transcription.
​
temperature
float | list[float]
default:"0"
Sampling temperature to use when decoding text tokens during transcription. Alternatively, fallback decoding can be enabled by passing a list of temperatures like 0.0,0.2,0.4,0.6,0.8,1.0. This can help to improve performance.
​
response_format
string
default:"json"
The format in which to return the response. Can be one of json, text, srt, verbose_json, or vtt.
​
timestamp_granularities
string | list[string]
The timestamp granularities to populate for this transcription. response_format must be set verbose_json to use timestamp granularities. Either or both of these options are supported. Can be one of word, segment, or word,segment. If not present, defaults to segment.
​
diarize
string
Whether to get speaker diarization for the transcription. Can be one of true, or false. If not present, defaults to false.Enabling diarization also requires other fields to hold specific values:
  1. response_format must be set verbose_json.
  2. timestamp_granularities must include word to use diarization.
​
min_speakers
int
The minimum number of speakers to detect for diarization. diarize must be set true to use min_speakers. If not present, defaults to 1.
​
max_speakers
int
The maximum number of speakers to detect for diarization. diarize must be set true to use max_speakers. If not present, defaults to inf.
​
preprocessing
string
Audio preprocessing mode. Currently supported:
  • none to skip audio preprocessing.
  • dynamic for arbitrary audio content with variable loudness.
  • soft_dynamic for speech intense recording such as podcasts and voice-overs.
  • bass_dynamic for boosting lower frequencies;

​
Response

  • json/text/srt/vtt
  • verbose_json
​
text
string
required

# Download audio file
curl -L -o "audio.flac" "https://tinyurl.com/4997djsh"

# Make request
curl -X POST "https://audio-prod.api.fireworks.ai/v1/audio/transcriptions" \
-H "Authorization: <FIREWORKS_API_KEY>" \
-F "[email protected]"

​
Supported Languages

The following languages are supported for transcription:
Language CodeLanguage Name
enEnglish
zhChinese
deGerman
esSpanish
ruRussian
koKorean
frFrench
jaJapanese
ptPortuguese
trTurkish
plPolish
caCatalan
nlDutch
arArabic
svSwedish
itItalian
idIndonesian
hiHindi
fiFinnish
viVietnamese
heHebrew
ukUkrainian
elGreek
msMalay
csCzech
roRomanian
daDanish
huHungarian
taTamil
noNorwegian
thThai
urUrdu
hrCroatian
bgBulgarian
ltLithuanian
laLatin
miMaori
mlMalayalam
cyWelsh
skSlovak
teTelugu
faPersian
lvLatvian
bnBengali
srSerbian
azAzerbaijani
slSlovenian
knKannada
etEstonian
mkMacedonian
brBreton
euBasque
isIcelandic
hyArmenian
neNepali
mnMongolian
bsBosnian
kkKazakh
sqAlbanian
swSwahili
glGalician
mrMarathi
paPunjabi
siSinhala
kmKhmer
snShona
yoYoruba
soSomali
afAfrikaans
ocOccitan
kaGeorgian
beBelarusian
tgTajik
sdSindhi
guGujarati
amAmharic
yiYiddish
loLao
uzUzbek
foFaroese
htHaitian Creole
psPashto
tkTurkmen
nnNynorsk
mtMaltese
saSanskrit
lbLuxembourgish
myMyanmar
boTibetan
tlTagalog
mgMalagasy
asAssamese
ttTatar
hawHawaiian
lnLingala
haHausa
baBashkir
jwJavanese
suSundanese
yueCantonese
zh-hantTraditional Chinese
zh-hansSimplified Chinese