Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
// Which extra multipart fields ask a BYOK transcription provider for
// segment-level timestamps, and how its verbose response maps back to
// segments. Gated per provider/model because unsupported combinations
// (gpt-4o-transcribe rejects verbose_json; custom/self-hosted servers may
// 400 on unknown fields) must keep the plain-text request untouched — a
// missing timestamp is a degraded export, never a failed upload.
function timestampRequestFields(provider, model) {
if (provider === "openai" && model === "whisper-1") {
return { response_format: "verbose_json" };
}
if (provider === "groq") {
return { response_format: "verbose_json" };
}
if (provider === "mistral") {
return { timestamp_granularities: "segment" };
}
return null;
}
// verbose_json (OpenAI/Groq) and Mistral's segment granularity both carry
// `segments: [{ text, start, end }]`. Null when the response has nothing
// usable, or when the kept segments don't hold every word of the response's
// text (whitespace aside, so CJK joins match), so callers fall back to the
// plain transcript rather than store a timed one with words missing.
function mapVerboseSegments(responseData) {
const segments = responseData?.segments;
if (!Array.isArray(segments)) return null;
const mapped = [];
for (const seg of segments) {
const text = typeof seg?.text === "string" ? seg.text.trim() : "";
if (!text || !Number.isFinite(seg.start)) continue;
const start = Math.max(0, seg.start);
const rawEnd = Number.isFinite(seg.end) ? seg.end : start;
const end = Math.max(start, rawEnd);
mapped.push({
text,
start,
end,
});
}
if (!mapped.length) return null;
if (typeof responseData.text === "string") {
const compact = (value) => value.replace(/\s+/g, "");
if (compact(mapped.map((seg) => seg.text).join("")) !== compact(responseData.text)) {
return null;
}
}
return mapped;
}
module.exports = { timestampRequestFields, mapVerboseSegments };