Skip to content

output-formats: note that pcm_16000 is version-gated - #11

Merged
luke-speechify merged 1 commit into
mainfrom
fix/pcm16000-version-caveat
Sep 15, 2026
Merged

luke-speechify merged 1 commit into
mainfrom
fix/pcm16000-version-caveat

Conversation

@luke-speechify

Copy link
Copy Markdown
Contributor

Every output-formats recipe offers pcm_16000 as the telephony choice with no qualification — in the README, and again in a comment beside the format list. The knowledge engine cites these recipes when asked which output_format to use for 16 kHz Twilio audio, and answers pcm_16000 flat.

On a workspace pinned before API version 2026-09-30, the Simba 3 models answer pcm_16000 with 24 kHz samples labelled rate=16000 — a 16 kHz pipeline plays them 1.5× slow and pitched down. Nothing errors; the audio is just wrong. A workspace created on or after 2026-09-30 is already correct, and an older pin keeps the bytes it has always received on purpose.

Ten files across five recipes (bash, python, typescript × native, SDK):

  • each README gains the caveat and the two ways out
  • each format list gains a one-line comment beside pcm_16000, so somebody copying the array sees it without reading the prose

Python and bash syntax-checked; the TypeScript edits are comments only.

Grounded in apps/server/swagger.yaml and the 2026-09-30 TTS changelog. Docs page: SpeechifyInc/speechify-api#4015 (merged). Skill: Speechify-AI/skills#2.

The docs page alone did not change the engine's answer — with it live and the cache flushed, retrieval still reached for the skill and these recipes first. These are the sources that actually move it.

Every output-formats recipe offers pcm_16000 as the telephony choice with no
qualification, in the README and again in a comment beside the format list. The
knowledge engine cites these recipes when asked which output_format to use for
16 kHz Twilio audio, and answers pcm_16000 flat.

On a workspace pinned before API version 2026-09-30 the Simba 3 models answer
pcm_16000 with 24 kHz samples labelled rate=16000, so a 16 kHz pipeline plays
them 1.5x slow and pitched down. Nothing errors; the audio is just wrong. A
workspace created on or after 2026-09-30 is already correct, and an older pin
keeps the bytes it has always received on purpose.

Each README gains the caveat and the two ways out, and each format list gains a
one-line comment beside pcm_16000 so somebody copying the array sees it without
reading the prose. Five recipes, bash, python and typescript, native and SDK.

Grounded in apps/server/swagger.yaml and the 2026-09-30 TTS changelog; the docs
page is SpeechifyInc/speechify-api#4015.
@luke-speechify
luke-speechify merged commit 84cf5d1 into main Sep 15, 2026
32 checks passed
@luke-speechify
luke-speechify deleted the fix/pcm16000-version-caveat branch September 15, 2026 19:12
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