hermes - 💡(How to fix) Fix [Bug]: KIMI_CODE_BASE_URL missing /v1 causes 404 on kimi-coding fallback calls [1 comments, 2 participants]

Bug Description

When Hermes falls back to kimi-coding provider, API calls fail with HTTP 404 because the built-in KIMI_CODE_BASE_URL is set to https://api.kimi.com/coding (without /v1), but the correct working endpoint is https://api.kimi.com/coding/v1.

Steps to Reproduce

1. Configure kimi-coding as a fallback provider in config.yaml
2. Use a Kimi API key with sk-kimi- prefix (triggers the built-in URL resolution)
3. Trigger a fallback call (e.g., when primary model fails)
4. Observe HTTP 404 errors

Expected Behavior

Kimi Coding API calls should succeed. The endpoint https://api.kimi.com/coding/v1/chat/completions should be used.

Actual Behavior

Hermes resolves the base URL to https://api.kimi.com/coding (from KIMI_CODE_BASE_URL in hermes_cli/auth.py), then appends /v1/chat/completions internally, resulting in requests to https://api.kimi.com/coding/v1/chat/completions. However, the actual path constructed is /coding/chat/completions (missing /v1 segment), yielding a 404.

Error log:

API call failed after 3 retries. HTTP 404: The requested resource was not found | provider=kimi-coding model=kimi-for-coding msgs=285 tokens=~60,481

Root Cause Analysis

In hermes_cli/auth.py line ~190:

KIMI_CODE_BASE_URL = "https://api.kimi.com/coding"

The _resolve_kimi_base_url() function (line 409) returns this value for keys with sk-kimi- prefix. Since the OpenAI-compatible client already appends /v1/chat/completions to the base URL, the final path becomes /coding/chat/completions instead of /coding/v1/chat/completions.

Testing confirms:

• https://api.kimi.com/coding → SSL timeout (unreachable)
• https://api.kimi.com/coding/v1/models → 200 OK, returns model list including kimi-for-coding

Proposed Fix

Change KIMI_CODE_BASE_URL from https://api.kimi.com/coding to https://api.kimi.com/coding/v1 in hermes_cli/auth.py.

# Before
KIMI_CODE_BASE_URL = "https://api.kimi.com/coding"

# After
KIMI_CODE_BASE_URL = "https://api.kimi.com/coding/v1"

Users can work around this by setting KIMI_BASE_URL=https://api.kimi.com/coding/v1 in their .env file.

Affected Component

• Configuration (config.yaml, .env, hermes setup)
• Agent Core (conversation loop, context compression, memory)

Environment

• OS: macOS 15.5 (Apple Silicon)
• Python: 3.11.15
• Hermes: latest (git main)