[Bug]: Openrouter APIError

[nanoport]

Bug Description

I am getting this repeatedly. i can use curl "https://openrouter.ai/api/v1/models" and get all the models fine. my api key has credits and is valid. it just stops working.
Is there any way to add logging to APIError to suggest which error code is it? https://openrouter.ai/docs/api/reference/errors-and-debugging
I have installed using docker. could that be the issue? but this was working and it just stopped working
API call failed (attempt 1/3): APIError
🔌 Provider: openrouter Model: anthropic/claude-opus-4.6
🌐 Endpoint: https://openrouter.ai/api/v1
📝 Error: Network connection lost.

Steps to Reproduce

Exception in thread Thread-17 (run_agent):
Traceback (most recent call last):
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 1045, in _bootstrap_inner
Nothing went wrong - all the research completed successfully! I just need to compile it into one document now. Let me write it out immediately.
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
self.run()
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 982, in run
self._target(*self._args, **self._kwargs)
File "/root/.hermes/hermes-agent/cli.py", line 5509, in run_agent
result = self.agent.run_conversation(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 6424, in run_conversation
raise api_error
File "/root/.hermes/hermes-agent/run_agent.py", line 5753, in run_conversation
response = self._interruptible_streaming_api_call(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3763, in _interruptible_streaming_api_call
raise result["error"]
File "/root/.hermes/hermes-agent/run_agent.py", line 3718, in _call
result["response"] = _call_chat_completions()
^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3581, in _call_chat_completions
for chunk in stream:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 49, in iter
for item in self._iterator:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 95, in stream
raise APIError(
openai.APIError: Network connection lost.

Expected Behavior

It should work without network errors.

Actual Behavior

Exception in thread Thread-17 (run_agent):
Traceback (most recent call last):
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 1045, in _bootstrap_inner
Nothing went wrong - all the research completed successfully! I just need to compile it into one document now. Let me write it out immediately.
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
self.run()
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 982, in run
self._target(*self._args, **self._kwargs)
File "/root/.hermes/hermes-agent/cli.py", line 5509, in run_agent
result = self.agent.run_conversation(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 6424, in run_conversation
raise api_error
File "/root/.hermes/hermes-agent/run_agent.py", line 5753, in run_conversation
response = self._interruptible_streaming_api_call(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3763, in _interruptible_streaming_api_call
raise result["error"]
File "/root/.hermes/hermes-agent/run_agent.py", line 3718, in _call
result["response"] = _call_chat_completions()
^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3581, in _call_chat_completions
for chunk in stream:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 49, in iter
for item in self._iterator:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 95, in stream
raise APIError(
openai.APIError: Network connection lost.

Affected Component

CLI (interactive chat)

Messaging Platform (if gateway-related)

N/A (CLI only)

Operating System

Ubuntu 24.04.4 LTS

Python Version

3.11.15

Hermes Version

Hermes Agent v0.4.0 (2026.3.18)

Relevant Logs / Traceback

Root Cause Analysis (optional)

Exception in thread Thread-17 (run_agent):
Traceback (most recent call last):
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 1045, in _bootstrap_inner
Nothing went wrong - all the research completed successfully! I just need to compile it into one document now. Let me write it out immediately.
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
self.run()
File "/root/.local/share/uv/python/cpython-3.11.15-linux-x86_64-gnu/lib/python3.11/threading.py", line 982, in run
self._target(*self._args, **self._kwargs)
File "/root/.hermes/hermes-agent/cli.py", line 5509, in run_agent
result = self.agent.run_conversation(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 6424, in run_conversation
raise api_error
File "/root/.hermes/hermes-agent/run_agent.py", line 5753, in run_conversation
response = self._interruptible_streaming_api_call(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3763, in _interruptible_streaming_api_call
raise result["error"]
File "/root/.hermes/hermes-agent/run_agent.py", line 3718, in _call
result["response"] = _call_chat_completions()
^^^^^^^^^^^^^^^^^^^^^^^^
File "/root/.hermes/hermes-agent/run_agent.py", line 3581, in _call_chat_completions
for chunk in stream:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 49, in iter
for item in self._iterator:
File "/root/.hermes/hermes-agent/venv/lib/python3.11/site-packages/openai/_streaming.py", line 95, in stream
raise APIError(
openai.APIError: Network connection lost.

Proposed Fix (optional)

No response

Are you willing to submit a PR for this?

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

[ygd58]

"Network connection lost" is a network-level error, not a Hermes bug — the TCP connection to OpenRouter was dropped mid-stream. This commonly happens with:

1. Docker network timeouts (default TCP keepalive may be too long)
2. ISP/router dropping long-lived connections
3. OpenRouter server-side disconnects on long requests

Suggested fixes:

• Try setting a shorter timeout: add HERMES_REQUEST_TIMEOUT=120 to your .env
• In Docker, add --network host or configure TCP keepalive
• Check if the issue correlates with long requests (>2 min)

If this happens consistently, it may be worth adding retry logic for openai.APIError: Network connection lost specifically.

[nanoport]

thanks for your suggestion.
theres no network error and it works perfectly in a new session. if i resume old session where research was done, the chat doesnt proceed any further with api calls.

[ygd58]

Thanks for the clarification. If it works in a new session but fails when resuming an old research session, this is likely a context size issue — the resumed session is too large and hitting the provider limit.

Try these steps:

1. In the chat, type /compress to manually trigger context compression
2. Or start a fresh session with /new and reference the old work

If the session silently fails with no API calls being made at all, check ~/.hermes/errors.log for more details — there may be a silent​​​​​​​​​​​​​​​​

[nanoport]

On old session the context is at 0. /new doesn't do anything on old session and it recurs with api errors.
/compress doesnt proceed either
ok now it proceeded with both /new and /compress but all context has been lost with session.
API call failed (attempt 1/3): APIError
🔌 Provider: openrouter Model: anthropic/claude-opus-4.6
🌐 Endpoint: https://openrouter.ai/api/v1
📝 Error: Network connection lost.

Error logs has this
2026-03-23 09:04:57,319 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:04:57,320 ERROR root: Request details - Messages: 2, Approx tokens: 3,259
2026-03-23 09:06:37,536 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:06:37,536 ERROR root: Request details - Messages: 3, Approx tokens: 3,276
2026-03-23 09:13:26,633 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:13:26,633 ERROR root: Request details - Messages: 2, Approx tokens: 3,252
2026-03-23 09:13:45,330 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:13:45,330 ERROR root: Request details - Messages: 3, Approx tokens: 3,269
2026-03-23 09:22:54,707 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:22:54,707 ERROR root: Request details - Messages: 4, Approx tokens: 3,277
2026-03-23 09:56:23,573 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:56:23,574 ERROR root: Request details - Messages: 5, Approx tokens: 3,285
2026-03-23 09:57:56,770 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 09:57:56,771 ERROR root: Request details - Messages: 6, Approx tokens: 3,362
2026-03-23 10:57:17,029 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 10:57:17,029 ERROR root: Request details - Messages: 2, Approx tokens: 3,286
2026-03-23 10:59:59,332 ERROR root: API call failed after 3 retries. Last error: Error code: 400
2026-03-23 10:59:59,332 ERROR root: Request details - Messages: 2, Approx tokens: 3,285
2026-03-23 11:45:59,872 ERROR root: API call failed after 3 retries. Last error: Network connection lost.
2026-03-23 11:45:59,872 ERROR root: Request details - Messages: 46, Approx tokens: 38,004
2026-03-23 11:54:35,784 ERROR root: API call failed after 3 retries. Last error: Network connection lost.
2026-03-23 11:54:35,784 ERROR root: Request details - Messages: 47, Approx tokens: 38,020
2026-03-23 12:01:59,657 ERROR root: API call failed after 3 retries. Last error: Network connection lost.
2026-03-23 12:01:59,658 ERROR root: Request details - Messages: 48, Approx tokens: 38,040
2026-03-23 12:08:59,144 ERROR root: API call failed after 3 retries. Last error: Network connection lost.
2026-03-23 12:08:59,145 ERROR root: Request details - Messages: 49, Approx tokens: 38,059

[ygd58]

Looking at your error logs, the real issue is Error code: 400 (not network errors). 400 with only 2-3 messages and ~3,259 tokens is a request format error, not a context size issue.

This often happens with anthropic/claude-opus-4.6 on OpenRouter when:

1. The model requires specific parameters not being sent
2. There's a malformed message in the conversation history

Try:

• Switch to a different model: /model openrouter/anthropic/claude-sonnet-4.6
• Check if the 400 error has more detail in a request dump at ~/.hermes/sessions/

The "Network connection lost" errors later (48+ messages, ~38k tokens) are separate — those appear to be genuine network drops after long requests.

[Mibayy]

Model: anthropic/claude-opus-4.6

This is not correct, should be claude-opus-4-6

do /model claude-opus-4-6