893f74f038
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.
41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
---
|
|
title: Replicate
|
|
---
|
|
|
|
Use Replicate's hosted TTS models as your provider.
|
|
|
|
## Setup
|
|
|
|
**Environment variables (recommended for deployment):**
|
|
|
|
```env
|
|
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](../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
|
|
|
|
- [Replicate](https://replicate.com/explore)
|
|
- [TTS Providers](../tts-providers)
|
|
- [TTS Environment Variables](../../reference/environment-variables#tts-provider-and-request-behavior)
|