openreader/docs-site/docs/guides/tts-providers.md
Richard R 6d5fb65a72 feat(docs): add configurable rate limiting and external docs
Add environment variables for fine-grained control over TTS rate limiting
and Better Auth behavior. Move documentation to external Docusaurus site
with automated deployment workflows.

- TTS rate limiting can now be enabled/disabled via TTS_ENABLE_RATE_LIMIT
- Customizable daily limits for anonymous/authenticated users and IP backstops
- Better Auth rate limiting can be disabled via DISABLE_AUTH_RATE_LIMIT
- Rename library import env vars to IMPORT_LIBRARY_DIRS/DIR
- Add docs-site with Docusaurus and GitHub Actions workflows
- Update README to reference external documentation
2026-02-10 15:11:37 -07:00

48 lines
1.6 KiB
Markdown

---
title: TTS Providers
---
OpenReader WebUI supports OpenAI-compatible TTS providers through a common API shape.
## Supported provider patterns
- OpenAI API
- DeepInfra
- Kokoro-FastAPI
- Orpheus-FastAPI
- Custom OpenAI-compatible endpoints
## Provider dropdown behavior
In Settings, the provider dropdown includes:
- `OpenAI`
- `Deepinfra`
- `Custom OpenAI-Like` (for Kokoro, Orpheus, and other compatible endpoints)
`API_BASE` guidance:
- For `OpenAI` and `Deepinfra`, OpenReader auto-fills the default endpoint.
- For `Custom OpenAI-Like`, set `API_BASE` to your server endpoint.
- In practice, you usually only set `API_BASE` when using a provider/endpoint that is not directly covered by the built-in dropdown defaults.
## Custom provider compatibility
For custom providers, OpenReader expects these endpoints:
- `GET /v1/audio/voices`
- `POST /v1/audio/speech`
If your provider exposes this interface, it can be used as an OpenAI-compatible TTS backend.
## Setup flow
1. Select your provider in the OpenReader Settings modal.
2. If using `Custom OpenAI-Like` (or overriding a default), set `API_BASE`.
3. Set `API_KEY` if required by your provider.
4. Choose model and voice.
For environment variables, see [Environment Variables](./environment-variables).
For TTS quota behavior, see [TTS Rate Limiting](./tts-rate-limiting).
For auth behavior, see [Auth](./configuration).
For provider-specific integration guides, see [Kokoro-FastAPI](../integrations/kokoro-fastapi), [Orpheus-FastAPI](../integrations/orpheus-fastapi), [Deepinfra](../integrations/deepinfra), [OpenAI](../integrations/openai), and [Custom OpenAI](../integrations/custom-openai).