nemotron-asr), as a file upload or as a live WebSocket stream.
Transcribe a file
POST /v1/audio/transcriptions takes a multipart/form-data upload and returns the transcript with word timestamps.
file(file, required) — PCM16 mono or WAV, up to 25 MB. Compressed audio is rejected; decode it first.model(string, required) —nemotron-asr.sample_rate(integer, optional, default 16000) — One of 8000, 16000, 22050, 24000, 44100, 48000.
words[].text(string) — The word. It can carry a leading space; trim it.words[].start,words[].end(number) — Offsets in seconds from the start of the audio.words[].conf(number) — Reserved; currently always 0.
Transcribe a long recording
nemotron-3.5-transcribe transcribes recordings up to 1 hour in 40 languages, with punctuation and capitalization, on the same POST /v1/audio/transcriptions.
file(file, required) — WAV, MP3, M4A, FLAC or Ogg, up to 128 MB.model(string, required) —nemotron-3.5-transcribe.language(string, optional) — ISO 639-1 code: ar, bg, bn, cs, da, de, el, en, es, et, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, lv, mr, mt, nl, pl, pt, ro, ru, sk, sl, sv, ta, te, th, tl, tr, uk, vi, zh.prompt(string, optional) — Instruction for the transcript, up to 4,000 characters.response_format(string, optional, defaultjson) —jsonreturns the text;verbose_jsonadds timestamps in OpenAI’s shape.timestamp_granularities[](string, optional, repeatable) — Withverbose_json:segment(default),word, or both.speaker_labels(boolean, optional, defaultfalse) — Beta. Labels who is speaking: each turn intextstarts with a tag such as<spk:0>, and withverbose_jsonevery word and segment carries an integerspeaker.
cURL
Word timestamps and speakers
cURL
words[].word(string) — The word as written, with its punctuation.words[].start,words[].end(number) — Seconds from the start of the file.words[].speaker,segments[].speaker(integer) — Only withspeaker_labels=true. Numbers tell speakers apart within one file; they are not identities.segments[]— Consecutive words grouped at pauses, sentence ends and speaker changes, withid,start,endandtext.
Stream live audio
wss://api.withhopper.com/stt/websocket transcribes audio as it arrives. Authenticate with the Authorization header, or with the api_key query parameter from clients that cannot set headers.
api_key(string, optional) — Your key, when noAuthorizationheader is sent.model(string, optional, defaultnemotron-asr) — STT model id.sample_rate(integer, optional, default 16000) — One of 8000, 16000, 22050, 24000, 44100, 48000.turn_detection(string, optional, defaultbalanced) —balanced,patientto wait longer before ending a turn, orresponsiveto end it sooner.
{"type": "Ready"} once, then you send binary PCM16 mono frames and receive transcript events. Send the text frame END to flush; the server replies with END when every final has been delivered.
text(string) — The turn’s transcript so far, lowercase and unpunctuated. It can carry a leading space.is_final(boolean) —trueon the last event of a turn; earlier events are partials that the next one replaces.audio_start,audio_end(number) — Where the text sits in the stream, in seconds.words(array) — Only on finals, in the same shape as the file response.