/** * Generates the 5 model catalog MDX pages from models/models.json and models/regions.json. * * Called by build-docs.js as part of the build pipeline. * Can also be run standalone: node scripts/generate-model-pages.js */ const fs = require("fs"); const path = require("path"); const MODELS_DATA = "models/models.json"; const REGIONS_DATA = "models/regions.json"; const MODELS_DIR = "models"; const PROVIDER_SECTIONS = { tts: [ { hosting: "slng", heading: "SLNG-hosted", description: "Models hosted and optimized on SLNG infrastructure for the lowest latency." }, { hosting: "Deepgram", heading: "Deepgram", description: "Direct proxy to Deepgram's TTS API." }, { hosting: "KugelAudio", heading: "KugelAudio", description: "Multilingual TTS with expressiveness control." }, { hosting: "Sarvam", heading: "Sarvam AI", description: "Indian-language specialist." }, ], stt: [ { hosting: "slng", heading: "SLNG-hosted", description: "Models hosted on SLNG infrastructure for optimized latency and throughput." }, { hosting: "Deepgram", heading: "Deepgram", description: "Direct proxy to Deepgram's STT API." }, { hosting: "Soniox", heading: "Soniox", description: "60+ language streaming speech recognition." }, { hosting: "Sarvam", heading: "Sarvam AI", description: "Indian-language specialist." }, ], }; const HOSTING_DISPLAY = { slng: "SLNG", Sarvam: "Sarvam AI" }; const AUTO_GEN_COMMENT = "{/* Auto-generated from models/models.json — do not edit directly */}"; // --------------------------------------------------------------------------- // Helpers // --------------------------------------------------------------------------- function formatJsxArray(arr) { return `{[${arr.map((s) => `"${s}"`).join(", ")}]}`; } function renderModelCard(model, { compact = false, indent = " " } = {}) { const regions = compact ? undefined : (model.cardRegions || model.regions); const href = model.href || (compact ? `/models/${model.type}` : undefined); if (compact) { const parts = [`name="${model.name}"`, `type="${model.type}"`, `provider="${model.provider}"`, `hosting="${model.hosting}"`, `features=${formatJsxArray(model.features)}`, "compact"]; if (href) parts.push(`href="${href}"`); return `${indent}`; } const lines = []; lines.push(`${indent}`); return lines.join("\n"); } // --------------------------------------------------------------------------- // Page generators // --------------------------------------------------------------------------- function generateTtsPage(models) { const ttsModels = models.filter((m) => m.type === "tts" && !m.regionOnly); const lines = [ "---", "title: Text-to-Speech Models", "description: Browse all TTS models available on the SLNG platform, grouped by provider.", "---", "", AUTO_GEN_COMMENT, "", 'import { ModelCard } from "/snippets/ModelCard.jsx";', ]; for (const section of PROVIDER_SECTIONS.tts) { const sectionModels = ttsModels.filter((m) => m.hosting === section.hosting); if (sectionModels.length === 0) continue; lines.push(""); lines.push(`## ${section.heading}`); if (section.description) { lines.push(""); lines.push(section.description); } lines.push(""); lines.push(""); for (const m of sectionModels) { lines.push(renderModelCard(m)); } lines.push(""); } fs.writeFileSync(path.join(MODELS_DIR, "tts.mdx"), lines.join("\n") + "\n"); } function generateSttPage(models) { const sttModels = models.filter((m) => m.type === "stt" && !m.regionOnly); const lines = [ "---", "title: Speech-to-Text Models", "description: Browse all STT models available on the SLNG platform, grouped by provider.", "---", "", AUTO_GEN_COMMENT, "", 'import { ModelCard } from "/snippets/ModelCard.jsx";', ]; for (const section of PROVIDER_SECTIONS.stt) { const sectionModels = sttModels.filter((m) => m.hosting === section.hosting); if (sectionModels.length === 0) continue; lines.push(""); lines.push(`## ${section.heading}`); if (section.description) { lines.push(""); lines.push(section.description); } lines.push(""); lines.push(""); for (const m of sectionModels) { lines.push(renderModelCard(m)); } lines.push(""); } fs.writeFileSync(path.join(MODELS_DIR, "stt.mdx"), lines.join("\n") + "\n"); } function generateByRegionPage(models, regionDefs) { const lines = [ "---", "title: Models by Region", "description: Find which SLNG models are deployed in your region.", "---", "", AUTO_GEN_COMMENT, "", 'import { ModelCard } from "/snippets/ModelCard.jsx";', "", "", " Models may be available in multiple regions. SLNG auto-selects the closest region by default. Use the `X-Region-Override` header to pin a specific region, or `X-World-Part-Override` to pin a broader geographic zone (`na`, `eu`, `ap`). See [Region & World-Part Overrides](/region-override) for details.", "", "", "", ]; for (const tabDef of regionDefs) { lines.push(` `); if (tabDef.placeholder) { lines.push(""); lines.push(` ${tabDef.placeholder}`); lines.push(""); } else { // Models available across the entire world-part (3rd-party proxies) if (tabDef.worldPart) { const wpModels = models.filter((m) => m.regions.includes(tabDef.worldPart)); if (wpModels.length > 0) { lines.push(` ### Available across ${tabDef.tab}`); lines.push(""); lines.push(" "); for (const m of wpModels) { lines.push(renderModelCard(m, { compact: true, indent: " " })); } lines.push(" "); lines.push(""); } } for (const region of tabDef.regions) { const regionModels = models.filter((m) => m.regions.includes(region.id)); if (regionModels.length === 0) continue; lines.push(` ### ${region.label}`); lines.push(""); lines.push(" "); for (const m of regionModels) { lines.push(renderModelCard(m, { compact: true, indent: " " })); } lines.push(" "); lines.push(""); } } lines.push(" "); lines.push(""); } // Remove trailing blank line before closing tag while (lines[lines.length - 1] === "") lines.pop(); lines.push(""); fs.writeFileSync(path.join(MODELS_DIR, "by-region.mdx"), lines.join("\n") + "\n"); } function generateByLanguagePage(models) { const nonRegionOnly = models.filter((m) => !m.regionOnly); // Collect languages and the models that support them const langMap = new Map(); for (const m of nonRegionOnly) { if (!m.languages) continue; for (const lang of m.languages) { if (!langMap.has(lang)) langMap.set(lang, []); langMap.get(lang).push(m); } } // Sort languages alphabetically, but "Indian Languages" goes last const sortedLangs = [...langMap.keys()].sort((a, b) => { if (a === "Indian Languages") return 1; if (b === "Indian Languages") return -1; return a.localeCompare(b); }); const lines = [ "---", "title: Models by Language", "description: Find TTS and STT models that support your target language.", "---", "", AUTO_GEN_COMMENT, "", 'import { ModelCard } from "/snippets/ModelCard.jsx";', "", "", " Many models support multiple languages. A model listed under one language may also appear under others. See individual model pages for the full list of supported languages and voices.", "", ]; for (const lang of sortedLangs) { const langModels = langMap.get(lang); lines.push(""); lines.push(`## ${lang}`); if (lang === "Indian Languages") { lines.push(""); lines.push("Models with dedicated support for Indian languages beyond Hindi, including Bengali, Gujarati, Kannada, Malayalam, Marathi, Odia, Punjabi, Tamil, and Telugu."); } lines.push(""); lines.push(""); for (const m of langModels) { lines.push(renderModelCard(m, { compact: true })); } lines.push(""); } fs.writeFileSync(path.join(MODELS_DIR, "by-language.mdx"), lines.join("\n") + "\n"); } function generateIndexPage(models) { const nonRegionOnly = models.filter((m) => !m.regionOnly); const ttsCount = nonRegionOnly.filter((m) => m.type === "tts").length; const sttCount = nonRegionOnly.filter((m) => m.type === "stt").length; const providers = new Set(nonRegionOnly.map((m) => m.provider)); // Count providers per type for browse cards const ttsProviders = new Set(nonRegionOnly.filter((m) => m.type === "tts").map((m) => m.provider)).size; const sttProviders = new Set(nonRegionOnly.filter((m) => m.type === "stt").map((m) => m.provider)).size; const lines = [ "---", "title: Model Catalog", "description: Browse all TTS and STT models available on the SLNG platform by provider or deployment region.", "---", "", AUTO_GEN_COMMENT, "", `SLNG gives you access to **${ttsCount} TTS models** and **${sttCount} STT models** from **${providers.size} providers** — all through a single API. Browse by type or find which models are deployed in your region.`, "", "## At a Glance", "", "### Text-to-Speech", "", "| Model | Provider | Hosting | Latency | Languages |", "|-------|----------|---------|---------|-----------|", ]; const ttsModels = nonRegionOnly.filter((m) => m.type === "tts"); const sttModels = nonRegionOnly.filter((m) => m.type === "stt"); for (const m of ttsModels) { const displayName = m.indexName || m.name; const displayHosting = HOSTING_DISPLAY[m.hosting] || m.hosting; const nameCell = m.href ? `[${displayName}](${m.href})` : displayName; lines.push(`| ${nameCell} | ${m.provider} | ${displayHosting} | ${m.latency} | ${m.languageSummary} |`); } lines.push(""); lines.push("### Speech-to-Text"); lines.push(""); lines.push("| Model | Provider | Hosting | Latency | Languages |"); lines.push("|-------|----------|---------|---------|-----------|"); for (const m of sttModels) { const displayName = m.indexName || m.name; const displayHosting = HOSTING_DISPLAY[m.hosting] || m.hosting; const nameCell = m.href ? `[${displayName}](${m.href})` : displayName; lines.push(`| ${nameCell} | ${m.provider} | ${displayHosting} | ${m.latency} | ${m.languageSummary} |`); } lines.push(""); lines.push("## Browse Models"); lines.push(""); lines.push(""); lines.push(` `); lines.push(` ${ttsCount} models from ${ttsProviders} providers.`); lines.push(` `); lines.push(` `); lines.push(` ${sttCount} models from ${sttProviders} providers.`); lines.push(` `); lines.push(` `); lines.push(` See which models are deployed in your region.`); lines.push(` `); lines.push(` `); lines.push(` Find models that support your target language.`); lines.push(` `); lines.push(""); fs.writeFileSync(path.join(MODELS_DIR, "index.mdx"), lines.join("\n") + "\n"); } // --------------------------------------------------------------------------- // Main entry point // --------------------------------------------------------------------------- function generateModelPages() { const models = JSON.parse(fs.readFileSync(MODELS_DATA, "utf8")); const regionDefs = JSON.parse(fs.readFileSync(REGIONS_DATA, "utf8")); generateTtsPage(models); generateSttPage(models); generateByRegionPage(models, regionDefs); generateByLanguagePage(models); generateIndexPage(models); const nonRegionOnly = models.filter((m) => !m.regionOnly); console.log(` Generated 5 model pages (${nonRegionOnly.length} models)`); } module.exports = { generateModelPages }; // Allow standalone execution if (require.main === module) { const repoRoot = path.resolve(__dirname, ".."); process.chdir(repoRoot); console.log("Generating model pages..."); generateModelPages(); }

Overview

LiveKit

Cognigy

Jambonz

​Available integrations

LiveKit

Cognigy

Jambonz

Available integrations