Skip to content

docs(lang): reconcile Lightning v3.1 Pro + Pulse language lists against live API - #389

Open
abhishekmishragithub wants to merge 2 commits into
mainfrom
fix/language-lists-audit
Open

docs(lang): reconcile Lightning v3.1 Pro + Pulse language lists against live API#389
abhishekmishragithub wants to merge 2 commits into
mainfrom
fix/language-lists-audit

Conversation

@abhishekmishragithub

Copy link
Copy Markdown
Collaborator

Summary

Two language-list discrepancies flagged by the founder, live-verified end to end against `api.smallest.ai`, and reconciled across every affected surface.

What was wrong

Lightning v3.1 Pro voices-languages page (text-to-speech/get-voice-models-langs.mdx)

  • European accordion header said "10 languages", table listed 10; Pro model card + spec enum both include Dutch (`nl`) and Swedish (`sv`) at 12.
  • Supported-languages summary table did not list `nl` or `sv` at all.

Pulse model card (speech-to-text/model-cards/pulse.mdx)

  • Claimed "22 pre-recorded languages" in six places, but the batch spec enum has 26 codes.
  • Batch language table was missing Latvian (`lv`), Estonian (`et`), Danish (`da`), and Maltese (`mt`).
  • Total "31 documented languages (21 streaming + 22 pre-recorded)" was consequently wrong; correct total is 35 (21 + 26 - 12 overlap).

Live verification

  • POST /waves/v1/tts with model=lightning_v3.1_pro, voice_id=meher, language=nl and language=sv: both HTTP 200, real audio synthesised (20 KB and 66 KB PCM).
  • POST /waves/v1/stt/?model=pulse&language=<code> for lv, et, da, mt: all pass language validation (same-shape response as en control); the missing rows were pure documentation debt.
  • GET /waves/v1/lightning-v3.1/get_voices shows every multilingual Pro voice (e.g. bellatrix, meher) carries dutch and swedish in tags.language.

What ships

  • text-to-speech/get-voice-models-langs.mdx: European accordion adds `nl` and `sv` rows (voice count "-"), header now says "12 languages"; supported-languages summary table adds both rows.
  • speech-to-text/model-cards/pulse.mdx: six "22" claims fixed to "26", "31 documented" fixed to "35 documented", batch language table adds `lv`/`et`/`da`/`mt` in enum order and renumbers.
  • New changelog entry.
  • Also picks up a missing `CodingAgentCallout` on `deprecation-notices.mdx` (dropped in earlier merge; injector script re-added it).

What was NOT changed

  • Multi-EU aggregator note reworded to "the European codes above" instead of "17 European codes" — the exact number the aggregator itself covers is not verified end-to-end (may or may not include the newly-added lv/et/da/mt). Confirm with the STT team before quoting a number.
  • Standard Lightning v3.1 (non-Pro) rows in the summary table were left with dashes where the model card says the codes are "accepted but routed via en/hi". That is a P1 documentation-clarity issue (dash reads as "unsupported"), separate ticket.

Test plan

  • fern check clean
  • Em-dash sweep on diff clean
  • POST /waves/v1/tts on both Pro nl and sv returns 200 with audio (see PR body)
  • Pulse batch language validation on lv, et, da, mt matches en control response shape
  • Preview render: verify the European accordion + Supported-languages table + Pulse batch accordion all display correctly

…st live API

Two long-standing gaps.

**Lightning v3.1 Pro voices-languages page** was missing Dutch (nl) and
Swedish (sv) from the European accordion and the Supported-languages
summary table. Both codes are in the tts-openapi.yaml enum, the model
card lists them with voice-count 'pending', and both synthesise cleanly
today via any multilingual Pro voice (verified with
POST /waves/v1/tts language=nl and language=sv).

**Pulse model card** claimed '22 pre-recorded languages' in six places
but the batch spec enum has 26 codes. Latvian (lv), Estonian (et),
Danish (da), Maltese (mt) were missing from the batch language table.
Reconciled the count to 26 batch + 21 streaming, 35 total (with 12-code
overlap). Batch table renumbered.

**CodingAgentCallout** was missing on deprecation-notices.mdx; the
injector script picked it up and added it during this pass.
@crim-app

crim-app Bot commented Aug 24, 2026

Copy link
Copy Markdown

crim doesn't review pull requests automatically here.

Comment crim review on this pull request whenever you want a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant