mARTin-B78/tts-voice-creator-clone-and-design-2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
b60586a559
tts-voice-creator-clone-and.../architecture/voice-archetypes.md
mARTin-B78 5dbe8c8998 docs(voices): archetype gallery manual and architecture 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 18:23:44 +02:00

2.3 KiB
Raw Blame History

Voice archetype gallery

Code: core/voice_archetypes.py (catalog + filter), routes/archetypes.py, UI static/js/voice-archetypes.js (core module) + card in static/sections/s-design.html.

Catalog: 40 entries authored here (no third-party data or code). Fields: id, name_de, name_en, instruct (free-text Qwen3 VoiceDesign description; German prompts transliterated to ASCII like the existing design presets), category (7 fixed), language (German/English), facets {gender, age, pitch, accent, tone} from the DESIGN_CHIPS vocabulary, sample_script_de/en (per category). Validated at import: unknown facet, category, language or duplicate/odd id raises ValueError (unit-tested).

API

  • GET /api/archetypes?gender&age&pitch&accent&language&category&q&offset&limit -> {total, items, categories, cached}; limit capped at 100, q at 100 chars.
  • POST /api/archetypes/{id}/preview -> WAV. Cache <CONFIG_DIR>/archetype_previews/<sha256(instruct|language|engine|seed)[:32]>.wav; engine is the configured voice-design model, seed fixed to 42 (injected as extra param for this call only). Rendering goes through _voice_design_request_audio inside the shared bounded TTS queue, 240 s timeout, per-key lock, size cap 8 MB, blank/too-short audio rejected (502), atomic write. Cache is naturally bounded by the catalog size.
  • POST /api/archetypes/{id}/use -> saves voice archetype_<id> (normalized WAV from the cached preview, reference text = sample script, meta origin: designed, voice_design_prompt). Idempotent: an existing voice returns created: false.

Provenance choice: core/provenance.BASES has no "synthetic" value, so basis is unknown (closest; nothing to consent to), source archetype/<id> (a : would be parsed as a URL scheme and rejected), note "synthetic designed voice".

UI: the card is a collapsed <details>; nothing is fetched or rendered until opened (DOM budget). 24 cards per page ("Load more"), favourites in localStorage (guarded), DE translations in i18n.js.

Pre-render: scripts/render_archetype_previews.py calls the preview endpoint for every entry (sequential, idempotent). No API key needed: the API-key gate accepts same-origin requests, so the script sends Origin: <base>; only local/LAN bases accepted.

Not done: per-archetype audio shipped in the repo, user-defined archetypes, community import.