Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix [Bug]: OpenRouter model auto-suffix ":free" causes 404 for paid models

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…

Error Message

Operating System

macOS 15.5

Python Version

No response

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause

Root Cause Analysis (optional)

Code Example

model:
  default: tencent/hy3-preview
  provider: openrouter
  base_url: https://openrouter.ai/api/v1

### Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

### Messaging Platform (if gateway-related)

_No response_

### Debug Report

---

### Operating System

macOS 15.5

### Python Version

_No response_

### Hermes Version

_No response_

### Additional Logs / Traceback (optional)
RAW_BUFFERClick to expand / collapse

Bug Description

When using OpenRouter as provider, Hermes Agent automatically appends :free suffix to model names. This causesHTTP 404 errors when models transition from free to paid tiers.

Steps to Reproduce

  1. Configure Hermes Agent with OpenRouter provider
  2. Set model to tencent/hy3-preview (which was free, now paid)
  3. Send a message via gateway (WeCom/Telegram/Discord)
  4. Check ~/.hermes/logs/gateway.log

Expected Behavior

• System should use the exact model name from config • OR gracefully handle model tier changes • OR allow users to explicitly control the :free suffix behavior

Actual Behavior

ERROR: HTTP 404: Hy3 preview is no longer available as a free model. It has transitioned to a paid model.

Gateway automatically resolves tencent/hy3-preview → tencent/hy3-preview:free, causing API failure.

Evidence from Logs

2026-05-11 16:27:11,182 ERROR [...] Final error: HTTP 404: Hy3 preview is no longer available as a free model. Continue using it here: https://openrouter.ai/tencent/hy3-preview

Configuration

model:
  default: tencent/hy3-preview
  provider: openrouter
  base_url: https://openrouter.ai/api/v1

### Affected Component

Gateway (Telegram/Discord/Slack/WhatsApp)

### Messaging Platform (if gateway-related)

_No response_

### Debug Report

```shell
-

Operating System

macOS 15.5

Python Version

No response

Hermes Version

No response

Additional Logs / Traceback (optional)

Root Cause Analysis (optional)

• CLI/TUI may work (unclear if :free suffix is applied) • Gateway platforms (WeCom, Telegram, etc.) fail with 404 • Users cannot use models that transitioned from free to paid tiers

Proposed Fix (optional)

  1. Add config option to disable auto-:free suffix (e.g., model.auto_free_suffix: false)
  2. OR remove auto-suffix logic entirely and let OpenRouter handle model resolution
  3. OR cache model tier info and avoid appending :free for paid-only models

Are you willing to submit a PR for this?

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

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#prompt formatting#chain error#conversation history#tool integration

Still need to ship something?

×6

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

Back to top recommendations

TRENDING