Skip to content

Add TTS feature recipes: models, voices, formats, i18n, versioning, errors, watermark - #8

Merged
luke-speechify merged 1 commit into
Speechify-AI:mainfrom
luke-speechify:cookbook-feature-recipes
Sep 8, 2026
Merged

luke-speechify merged 1 commit into
Speechify-AI:mainfrom
luke-speechify:cookbook-feature-recipes

Conversation

@luke-speechify

Copy link
Copy Markdown
Contributor

Adds runnable recipes for the TTS API surfaces the cookbook didn't cover yet, each in every applicable lane (TypeScript SDK/native, Python SDK/native, Bash).

Builds on #6 (v4 SDK bump) and #7 (verified-consent voice cloning), already merged.

New recipes

  • list-modelsmodels.list() / GET /v1/audio/models
  • list-voicesvoices.list() with pagination
  • voice-language-model-support — which model + language combos a voice supports
  • version-pinning-and-idempotencySpeechify-Version + Idempotency-Key (replay proven)
  • error-handling — typed errors, error codes, Retry-After, request ids
  • multilinguallanguage param + simba-3.0
  • output-formatsoutput_format codec/sample-rate/bitrate (telephony ulaw/pcm)
  • watermark/v1/audio/watermark/{detect,verify} — REST-only, not in the SDKs, so native lanes only

Notes

  • Verified end-to-end against the live API on every lane. Voice cloning's success path can't be automated (verified consent needs a real same-speaker recording); its error path is covered.
  • Also reformats five voice-cloning files that had drifted from Prettier on main, so format:check is green.
  • Ignores pcm/ulaw artifacts and agent worktrees.

DRG-484

Adds runnable recipes for API surfaces the cookbook didn't cover yet, each in
every applicable lane (TypeScript SDK/native, Python SDK/native, Bash):

- list-models, list-voices, voice-language-model-support
- version-pinning-and-idempotency, error-handling
- multilingual (language param + simba-3.0), output-formats (telephony/bitrate)
- watermark detect/verify (REST-only — not in the SDKs)

Update the README index and COVERAGE matrix; ignore pcm/ulaw artifacts and agent
worktrees. Also reformats five voice-cloning files that had drifted from Prettier
on main, so format:check stays green.

The v4 SDK bump and verified-consent voice cloning already landed (Speechify-AI#6, Speechify-AI#7); this
builds on them. Verified end-to-end against the live API on every lane.
@luke-speechify
luke-speechify marked this pull request as ready for review September 8, 2026 18:12
@luke-speechify
luke-speechify merged commit 3ae8a07 into Speechify-AI:main Sep 8, 2026
28 checks passed
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