openreader/docs-site/docs/integrations/custom-openai.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

824 B

title
Custom OpenAI

Use any custom OpenAI-compatible TTS service with OpenReader.

Use this integration when your endpoint is not directly covered by built-in dropdown defaults.

Compatibility requirements

Your provider should expose:

  • GET /v1/audio/voices
  • POST /v1/audio/speech

OpenReader setup

  1. In OpenReader settings, choose provider Custom OpenAI-Like.
  2. Pick model Kokoro, Orpheus, or Other as appropriate.
  3. Set API_BASE to your service base URL.
  4. Set API_KEY if required by your service.
  5. Choose voice.

Notes

  • API_BASE is required for this provider path because OpenReader cannot infer your custom host.
  • If voices do not load, verify the /v1/audio/voices response format.
  • For variable details, see Environment Variables.