danvics/openreader
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
openreader/docs-site/docs/configure/tts-provider-guides/replicate.md
Richard R 893f74f038 refactor(tts): update Replicate model defaults and voice resolution 
Align default Replicate model to the versioned Kokoro model across UI, docs,
and server logic. Refactor TTS settings merging for audiobooks to ensure
consistent normalization. Improve Retry-After header handling for upstream
rate limits. Expand Replicate voice resolution to use model schemas when
available, with test coverage for custom and built-in models.

Update documentation to reflect new Replicate defaults, model selection,
and configuration guidance.
2026-04-16 12:52:08 -06:00

1.4 KiB
Raw Blame History

title
Replicate

Use Replicate's hosted TTS models as your provider.

Setup

Environment variables (recommended for deployment):

API_KEY=r8_...
NEXT_PUBLIC_DEFAULT_TTS_PROVIDER=replicate
NEXT_PUBLIC_DEFAULT_TTS_MODEL=alphanumericuser/kokoro-82m:89b6fa84e4fa2dd6bd3a96be3e1f12827a3516c9fda8fddbac7a0be131c9a6f5

Or in-app via Settings -> TTS Provider:

  1. Set provider to Replicate.
  2. Enter your API_KEY.
  3. Choose a model and voice.

Settings modal values override env vars. See TTS Providers for how the two layers interact.

Notes

  • Built-in Replicate models:
    • alphanumericuser/kokoro-82m:89b6fa84e4fa2dd6bd3a96be3e1f12827a3516c9fda8fddbac7a0be131c9a6f5
    • google/gemini-3.1-flash-tts
    • minimax/speech-2.8-turbo
    • qwen/qwen3-tts
    • inworld/tts-1.5-mini
  • You can also choose Other and enter any Replicate model ID (for example owner/model-name or owner/model-name:version).
  • Native model speed is not available on all Replicate models; OpenReader hides/disables native speed controls where unsupported.
  • TTS requests are sent from the server, not the browser. The API key is never exposed to clients.

References