DEL-33165: Add Melia 1, split Models and Languages pages by cabbage-ice-cream · Pull Request #258 · speechmatics/docs

cabbage-ice-cream · 2026-06-12T11:08:34Z

Summary

Implements the approved Melia 1 model docs content:

New Models page (docs/speech-to-text/models.mdx) comparing Enhanced, Standard, and Melia 1, with model selection, Melia 1 details, and the operating points deprecation note (DEL-33165)
Languages page replaced: H1 changes from "Languages and models" to "Languages"; model content moves to the new Models page; packs section renamed to "Bilingual and multi-language packs"; slug unchanged
Batch Input page: new "Multilingual transcription with Melia 1" subsection under Job configuration options, after the JobConfig schema. Generated schema blocks untouched.
Batch Output page: new "Multilingual transcript output" subsection under Load and process the transcript, after Example response. Generated schema blocks untouched.
Navigation (DEL-33183): Models nav item added above Languages; the Languages nav label renames automatically with the page title
Links and redirects (DEL-33182): see below

Redirects and anchors (DEL-33182)

Fragment redirects are not implementable: Vercel redirects are path-based and URL fragments never reach the server, so neither /speech-to-text/languages#operating-points → /speech-to-text/models nor an #multilingual-speech-to-text → #bilingual-and-multi-language-packs redirect can be added. vercel.json is unchanged (no page paths changed). External links to the old anchors will land at the top of the Languages page, which now points readers to Models in its intro.

All internal inbound links were updated instead:

#multilingual-speech-to-text → #bilingual-and-multi-language-packs: features/feature-discovery.mdx (×2), deployments/index.md, deployments/container/cpu-speech-to-text.mdx
#operating-points → /speech-to-text/models: features/audio-filtering.mdx (note: this anchor did not exist on the current Languages page either — the link was already stale)
languages#models → /speech-to-text/models: deployments/container/gpu-speech-to-text.mdx, deployments/container/cpu-speech-to-text.mdx — the old ### Models heading disappears with this change, so these would otherwise become broken anchors

Adaptations to repo conventions (no wording changes beyond these)

Absolute docs.speechmatics.com URLs converted to root-relative links
"prioritises" → "prioritizes" on the Models page (brief mandates en-US)
Existing keywords frontmatter on the Languages page preserved; title/description taken from the approved content
melia and the Arabic example word (مرحبا) added to custom-words.txt for cspell

Known open items — intentional, not oversights

The Operating points note on the Models page is scoped to SaaS deployments only; on-prem status unconfirmed. Wording left exactly as approved.
The multilingual example values in the Output insertion are illustrative, pending verification against a real Melia 1 job response.
The language_pack_info per-language object shape is an open question for the spec owner; the authored example stands as written.

Verification

npm run build passes (broken internal links throw; none found). The 5 broken-anchor warnings in the build log are pre-existing on main and unrelated to these pages.
Built output checked: both pages render with correct titles, nav shows Models above Languages, both insertions present.
cspell clean on all four changed content pages (one pre-existing Quicklinks warning on the Output page also exists on main).

Terminology note for a follow-up: deployments/index.md labels the packs feature "Multilingual speech to text" and cpu-speech-to-text.mdx says "multi-lingual transcription" — under the new terminology ("multilingual" reserved for Melia 1) these labels are now off, but renaming them was out of scope here. Only their link targets were updated.

🤖 Generated with Claude Code

- Add new Models page at /speech-to-text/models covering Enhanced, Standard, and Melia 1 (DEL-33165) - Replace Languages and models page with Languages (slug unchanged) - Add Melia 1 multilingual subsections to Batch Input and Output pages - Add Models nav item above Languages (DEL-33183) - Update inbound links to moved/renamed anchors (DEL-33182) - Add melia and Arabic example word to custom-words.txt Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel · 2026-06-12T11:08:39Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jun 12, 2026 2:45pm

…oint` references

yaiir-a · 2026-06-12T11:41:05Z


 <SchemaNode schema={batchSchema.definitions.JobConfig} />

+### Multilingual transcription with Melia 1


This is very hard to find - should be visible in the table of contents imo.

Should also be linked to via the feature comparison table on the models page.

Done — raised the page's toc_max_heading_level to 3 so the section shows in the TOC, and linked it from the comparison table's "Automatic multilingual" cell on the Models page.

yaiir-a · 2026-06-12T11:42:00Z

+| Turnaround | Fast | Fastest | Fast |
+| Processing modes | Batch and Realtime | Batch and Realtime | Batch |
+| Regions | EU, US, AUS | EU, US, AUS | EU, US |
+| Language handling | Selected language or pack | Selected language or pack | Automatic multilingual |


Should link to batch lang ID and language hints as appropriate

Done — "Selected language or pack" now links to Languages with an auto-detect link to batch Language Identification, and "Automatic multilingual" links to the language hints section on the Input page.

yaiir-a · 2026-06-12T11:43:16Z

+
+Melia 1 is available for Batch transcription in the EU and US regions only. It is not available in the Australia (AU1) region.
+
+| Region | Endpoint |


Should this instead be on the authentication page? Or at lease linked to from there?

Kept the table here so the Melia 1 section stays self-contained, and added a line under Supported endpoints on the authentication page noting Melia 1's regional availability with a link back here.

yaiir-a · 2026-06-12T11:44:59Z

+| Processing modes | Batch and Realtime | Batch and Realtime | Batch |
+| Regions | EU, US, AUS | EU, US, AUS | EU, US |
+| Language handling | Selected language or pack | Selected language or pack | Automatic multilingual |
+| Custom dictionary | ✅ | ✅ | Not yet |


Do we need notes / warning on the relevant pages to say that these aren't yet supported on Melia?

Agreed in principle — but that's ~10 feature pages of new content, and Melia 1's feature support is expanding, so those notes need a maintenance plan. Proposing we raise a follow-up ticket for it rather than grow this PR. The comparison table on the Models page is the canonical list in the meantime.

Raised https://speechmatics.atlassian.net/browse/DEL-33243 to track this.

yaiir-a · 2026-06-12T11:45:55Z

+
+Melia 1 matches the Enhanced and Standard models for core transcription features, including diarization, word timings, punctuation, notifications, and output locale. It does not yet support the following features, which are available with the Enhanced and Standard models:
+
+- Custom vocabulary and formatting: custom dictionary, find and replace, spoken form output, profanity tagging


I feel like this section should be part of the compare the models section, otherwise users have to check multiple places for this information

Done — moved the unsupported-features list (and the early-access note) up into Compare the models, so the table and the detail are in one place. The Melia 1 section now links back to it.

yaiir-a · 2026-06-12T11:49:17Z

-```
+To choose a transcription model, refer to [Models](/speech-to-text/models).

+The languages, packs, and options on this page apply to the Enhanced and Standard models. The Melia 1 model is multilingual: it transcribes the individual languages listed here and switches between them automatically, without language selection. It does not support the `auto` option, the bilingual and multi-language packs, or translation. For Melia 1, refer to [Models](/speech-to-text/models).


These language codes are also relevant for melia - it shows which languages can be transcribed by the model, as well as the codes to use for language hints.
Note that the bilingual codes arent relevant for melia.

Done — the intro now says the language codes double as language hints for Melia 1 (linked to the Input section), and clarifies it's the bilingual/multi-language pack codes specifically that don't apply.

yaiir-a · 2026-06-12T11:50:30Z

+| Norwegian Bokmål (no) | Norwegian Nynorsk (nn) |

-## Multilingual speech-to-text
+## Bilingual and multi-language packs


Would be a good place to spotlight and direct users to Melia a bit more prominently IMO - its pretty hidden away currently.

Done — promoted that pointer to a note at the top of the packs section, same wording, much more visible.

- Show H3 sections in the Input page TOC (toc_max_heading_level 2 -> 3) - Link comparison table cells to Languages, Language Identification, and the new Input multilingual section - Deep-link the Input/Output references on the Models page to the new section anchors - Note Melia 1 regional availability under Supported endpoints on the authentication page, linking to Models Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…/speechmatics/docs into del-33165-melia-models-languages

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…1 on Languages page - Move the Melia 1 unsupported-features list into Compare the models so feature differences live in one place - Note that language codes double as Melia 1 language hints in the Languages page intro - Promote the Melia 1 pointer in the packs section to a note at the top of the section Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…ion not yet on Melia 1 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel Bot deployed to Preview June 12, 2026 11:09 View deployment

mnemitz added 2 commits June 12, 2026 12:10

Split "Languages and models" into separate pages, update `operating_p…

48183e2

…oint` references

Update spec

123d3fc

mnemitz changed the base branch from main to melia-1-docs June 12, 2026 11:15

Merge branch 'melia-1-docs' into del-33165-melia-models-languages

603d0f6

vercel Bot deployed to Preview June 12, 2026 11:22 View deployment

mnemitz changed the base branch from melia-1-docs to main June 12, 2026 11:22

mnemitz marked this pull request as ready for review June 12, 2026 11:23

yaiir-a reviewed Jun 12, 2026

View reviewed changes

cabbage-ice-cream and others added 4 commits June 12, 2026 14:19

Merge branch 'del-33165-melia-models-languages' of https://github.com…

08ffc11

…/speechmatics/docs into del-33165-melia-models-languages

Use root-relative links in languages table per repo convention

12523fe

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel Bot deployed to Preview June 12, 2026 13:33 View deployment

Remove intro lines that restate page titles; note speaker identificat…

e8fffc5

…ion not yet on Melia 1 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

vercel Bot deployed to Preview June 12, 2026 14:45 View deployment


		<SchemaNode schema={batchSchema.definitions.JobConfig} />

		### Multilingual transcription with Melia 1


		Melia 1 is available for Batch transcription in the EU and US regions only. It is not available in the Australia (AU1) region.

		\| Region \| Endpoint \|


		Melia 1 matches the Enhanced and Standard models for core transcription features, including diarization, word timings, punctuation, notifications, and output locale. It does not yet support the following features, which are available with the Enhanced and Standard models:

		- Custom vocabulary and formatting: custom dictionary, find and replace, spoken form output, profanity tagging

Conversation

cabbage-ice-cream commented Jun 12, 2026

Summary

Redirects and anchors (DEL-33182)

Adaptations to repo conventions (no wording changes beyond these)

Known open items — intentional, not oversights

Verification

Uh oh!

vercel Bot commented Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

yaiir-a Jun 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

3 participants

vercel Bot commented Jun 12, 2026 •

edited

Loading

yaiir-a Jun 12, 2026 •

edited

Loading