Base URL Rules & 404 Prevention

The most frequent integration error is appending extra path segments, which produces 404 Not Found or Invalid URL responses.

Nyxos API exposes an OpenAI-compatible /v1 API and accepts Anthropic-native /v1/messages traffic on the same host: https://api.nyxos.shop.

---

The Two URL ParadigmsCopy Anchor Link

1. Root Gateway URL: https://api.nyxos.shopCopy Anchor Link

Use the bare host when the client or SDK appends /v1 (or /v1/chat/completions) itself.

• Typical clients:
  • NextChat, Chatbox, LibreChat, Cherry Studio — these apps build the full endpoint path from the host you enter.
  • Official Anthropic Python/Node SDKs (base_url="https://api.nyxos.shop" → the SDK calls /v1/messages).
  • Claude Code CLI (ANTHROPIC_BASE_URL="https://api.nyxos.shop").
  • Any tool that builds the full path internally from the root domain.

CRITICAL WARNING — the double /v1 trap: If a client auto-appends /v1 and you entered https://api.nyxos.shop/v1, requests resolve to /v1/v1/chat/completions and fail with 404 Not Found. When in doubt, try the root URL first.

---

2. Explicit OpenAI URL: https://api.nyxos.shop/v1Copy Anchor Link

Use the explicit /v1 suffix when the client expects a complete OpenAI base endpoint.

• Typical clients:
  • Official OpenAI Python / Node SDKs (OpenAI(base_url=".../v1", api_key="sk-...")).
  • Cursor (Override OpenAI Base URL).
  • Codex CLI (base_url in ~/.codex/config.toml).
  • Cline, Kilo Code / Roo Code (OpenAI Compatible providers).
  • LobeChat / LobeHub (API Proxy Address).
  • Continue.dev, CodeGPT (apiBase).

---

Compatibility Matrix SummaryCopy Anchor Link

Rule of thumb: start with the explicit /v1 form. If you see 404 with /v1/v1/... in the request log, remove the suffix and use the root URL.