Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Feature]: Add OpenRouter as a TTS provider [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#15726•Fetched 2026-04-26 05:25:31
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
Stream5710Stream5710
Participants
Stream5710Stream5710
Timeline (top)
labeled ×4

Code Example

tts:
  provider: "openrouter"
  openrouter:
    model: "openai/gpt-4o-mini-tts-2025-12-15"
    voice: "alloy"
    speed: 1.0 # only supported on some models

---
RAW_BUFFERClick to expand / collapse

Problem or Use Case

Add official support for OpenRouter's new text-to-speech API which features models such as GPT-4o Mini TTS, Voxtral Mini TTS and Gemini 3.1 Flash TTS Preview.

Motivation

  • While some of the models available are already supported via other providers, Users who already have their OPENROUTER_API_KEY set up can enable TTS with no extra accounts, keys or setting up billing
  • Compatible with OpenAI TTS API which is already supported so it can be possibly implemented without a lot of code changes

Docs

Official guide: https://openrouter.ai/docs/guides/overview/multimodal/tts API reference: https://openrouter.ai/docs/api/api-reference/tts/create-audio-speech

Proposed Solution

  • Use OPENROUTER_API_KEY and existing openrouter authentication flow, either one for LLMs or tools/openrouter_client.py
  • .hermes/config.yaml schema:
tts:
  provider: "openrouter"
  openrouter:
    model: "openai/gpt-4o-mini-tts-2025-12-15"
    voice: "alloy"
    speed: 1.0 # only supported on some models

Alternatives Considered

No response

Feature Type

Other

Scope

None

Contribution

  • I'd like to implement this myself and submit a PR

Debug Report (optional)

extent analysis

TL;DR

Implement the OpenRouter text-to-speech API by utilizing the existing OPENROUTER_API_KEY and authentication flow, and update the .hermes/config.yaml schema to support the new TTS models.

Guidance

  • Review the official OpenRouter API documentation to understand the requirements for integrating the new TTS models.
  • Update the openrouter_client.py tool to support the TTS API, if necessary, and ensure compatibility with the existing authentication flow.
  • Modify the .hermes/config.yaml schema to include the new TTS provider and model configurations, as proposed in the solution.
  • Test the implementation with different TTS models and voices to ensure compatibility and correct functionality.

Example

tts:
  provider: "openrouter"
  openrouter:
    model: "gpt-4o-mini-tts-2025-12-15"
    voice: "alloy"
    speed: 1.0

Notes

The implementation may require additional error handling and logging to ensure robustness and debuggability.

Recommendation

Apply workaround by implementing the proposed solution, as it leverages the existing authentication flow and API key, making it a straightforward and efficient approach.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#pipeline error#runtime error#dependency conflict#environment setup

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix [Feature]: Add OpenRouter as a TTS provider [1 participants]