NyxosNyxos API
Troubleshooting

Troubleshooting Common Errors

Diagnose and fix 401, 404 and 429 errors, plus vision support and model access questions.

Most integration problems fall into three categories: wrong Base URL, wrong/misconfigured token, or wrong model access. Work through the sections below in order.

401 — Unauthorized / Invalid API Key

  • Verify you copied the complete key, including the sk- prefix, with no leading/trailing spaces.
  • Check the key is enabled in the panel's API Keys section (sidebar → Console → API Keys).
  • If you are using a client with its own proxy settings, make sure it isn't overriding your Authorization header.

404 — Model Not Found / Not Found

  1. Double /v1 path: the client auto-appended /v1 to a base URL that already contained it (/v1/v1/...). Switch the Base URL from https://api.nyxos.shop/v1 to https://api.nyxos.shop — see Base URL Rules.
  2. Model ID typo: the model field must match the ID on the /pricing page exactly. Copy it verbatim.
  3. Group access: your key's group may not include that model. Check the Enabled Groups column on /pricing, then edit the key's group in API Keys — for the widest coverage use the automatic Auto-A group (see Groups & Multipliers).

429 — Insufficient Quota (when the account has balance)

Each API key has its own independent quota limit on top of the account balance — a safety net against runaway agent loops.

If the account has funds but requests fail with 429:

  1. Confirm the account balance in Wallet (sidebar → Personal center → Wallet).
  2. Open API Keys and Edit the key you are calling with.
  3. Raise its quota or set it to Unlimited, then save.

Also check rate limits: different groups route through channels with different concurrency thresholds — see Groups & Multipliers.

Can I send images (Vision) or files?

Only multimodal models support image input. Vision-capable variants (certain Claude, GPT and Gemini models) accept images via URL or base64 in the standard message format; text-only models will reject image payloads.

Check the /pricing page and GET /v1/models metadata to confirm which models advertise vision/modalities, then use the exact ID in your request.

Still stuck?

  • Run the minimal health check: curl https://api.nyxos.shop/v1/models -H "Authorization: Bearer sk-...". If that works, the problem is in your client configuration, not the gateway.
  • Contact Nyxos support via Telegram: t.me/nyxos_shop with your account email/ID, the failing endpoint, and the exact error body.

Python & Node.js SDK Integration

Code examples using the official OpenAI and Anthropic SDKs with a Nyxos gateway.

On this page

401 — Unauthorized / Invalid API Key404 — Model Not Found / Not Found429 — Insufficient Quota (when the account has balance)Can I send images (Vision) or files?Still stuck?