Authentication troubleshooting

Fix invalid API key errors

Invalid-key errors mean the request is not reaching CorvusLLM with the active customer key in the auth field that the endpoint expects. Recopy the active key from the dashboard, send it as a Bearer token for OpenAI-compatible clients, and test with /v1/models before editing the rest of your app.

invalid api key unauthorized 401 403 missing bearer token authentication failed

Direct answer

Invalid-key errors mean the request is not reaching CorvusLLM with the active customer key in the auth field that the endpoint expects. Recopy the active key from the dashboard, send it as a Bearer token for OpenAI-compatible clients, and test with /v1/models before editing the rest of your app.

Use this page for public troubleshooting only.

Private order, key, and balance details belong in the customer portal or support. Public docs can explain the diagnostic path, not reveal account-specific state.

Error phrases this guide covers

Search tools, logs, and support tickets do not always use the same wording. Treat these phrases as the same troubleshooting family before changing unrelated settings.

invalid api key unauthorized 401 403 missing bearer token authentication failed

Fast check before changing everything

Run the smallest check that isolates the failing layer. If the small request works, the problem is usually the client configuration, hidden context, permissions, or advanced feature path rather than the whole account.

Authentication check
curl https://base.corvusllm.com/v1/models \
  -H "Authorization: Bearer YOUR_CORVUSLLM_KEY"

Common causes

  • The key was copied with a missing character, an extra space, or a line break from a password manager or chat app.
  • The app is still reading an old environment variable from another shell, server process, or hosted secret store.
  • The client sends the key in the wrong field, for example as a model parameter instead of an Authorization header.
  • A team member rotated or replaced the key but the production app kept the older value.

Fix steps

  1. Copy the active CorvusLLM key again from the customer dashboard or delivery source you trust.
  2. For OpenAI-compatible requests, send Authorization: Bearer YOUR_CORVUSLLM_KEY.
  3. Restart the app, terminal, or worker process that reads the environment variable.
  4. If curl works but the app fails, inspect exactly which variable name or settings profile the app reads at runtime.

Verify before retrying production traffic

  • Run /v1/models with the same key outside your app.
  • Confirm the same key is not being mixed with an official provider base URL.
  • Confirm hosted environments, CI, Docker containers, and local shells all use the same updated secret.
Do not use expensive retry loops as a diagnostic tool.

Use one small request first. Large retries can spend balance, hide the original cause, and create confusing logs.

Diagnostic decision tree

Work through these checks in order. The goal is to isolate the failing layer before editing unrelated settings or sending another expensive request.

Check Action Pass result Fail result
Minimal request Run the smallest check from this page with the same key, endpoint shape, and one public model slug. The account and basic route probably work; move to client settings, hidden context, tools, or retries. Fix auth, base URL, balance, model slug, or current route health before testing advanced features.
Client final URL Inspect the actual URL or provider profile the client sends, not only the visible settings field. Continue with request body, model slug, payload size, and feature compatibility checks. Correct host/base/full-endpoint confusion before changing keys or model families.
Balance movement Compare dashboard balance before and after one tiny diagnostic request. If charged and no answer arrives, collect the support packet before retrying large prompts. If not charged, focus first on request rejection, wrong endpoint, auth, or client-side failure.
Feature isolation Disable streaming, tools, images, file context, long history, and automation loops for one retry. Re-enable one feature at a time until the failing layer is identified. Keep the request small and do not use production retries as the diagnostic method.
Route health Check Service Status and try a tiny prompt on one nearby public model row if your workflow allows it. Use a documented fallback only if quality and cost are acceptable. Wait, switch safely, or contact support with timestamps instead of hammering the failing route.

Prevent it next time

Store the key in one secure environment variable per environment and document which app reads it. Never commit API keys, and avoid copying them through rich-text tools that can add invisible characters.

Minimum support packet

Collect these details before opening support. This avoids exposing secrets while giving enough context to match logs and reproduce the public failure path.

Field Why support needs it
Timestamp Use UTC or include timezone so logs can be matched accurately.
Endpoint path Include /v1, /anthropic, or the exact client route shape involved.
Public model slug Send the customer-facing slug, not a private key, upstream account name, or hidden route.
Exact error text Include the visible invalid API key message and any HTTP status shown by the client.
Minimal request result State whether the tiny check on this page works with the same key.
Balance movement State whether balance changed after the failed request or only after retries.
Client and feature flags Name the tool, SDK, streaming setting, image input, tools, file context, or automation loop involved.

When to contact support

Contact support when a minimal reproducible check still fails, when the dashboard history does not match what your client received, or when usage appears charged but no usable answer reached the client.

  • Include timestamp, endpoint path, public model slug, exact error wording, and whether the same key works on a minimal request.
  • Include whether the dashboard balance changed and whether the client retried in the background.
  • Do not send secrets, full API keys, regulated data, or private production prompts in public support messages.

Open the support bot after collecting the reproducible details.

Use these pages to verify the exact base URL, model slug, billing behavior, service status, or broader troubleshooting route before changing unrelated settings.

Topic map

Continue with the right source

Open the exact setup, model, billing, and troubleshooting pages instead of guessing configuration values.

docs API base URLs and request paths. API Overview: Base URLs, authentication, request formats, OpenAI-compatible vs Anthropic-native paths. docs Your key appears in more than one place, and all roads lead to the same dashboard. Delivery, Login & Top-Ups: Where your key appears, how to log in, how the personal dashboard works. trust Trust Center The Trust Center explains affiliation, data handling, support, refunds, compatibility evidence, pricing methodology. docs Set up CorvusLLM without guessing. Overview: The clean start page: base URLs, model overview, environment overview, and where to begin. docs Most CorvusLLM issues are the same four mistakes. Troubleshooting: Clear fixes for wrong base URLs, bad model slugs, out-of-balance errors, delivery questions. docs Use the canonical customer slug and keep it simple. Models & Slugs: Every customer-facing model with one customer slug, provider family, pricing. docs bills against the customer key balance and stops at zero. Billing, Balance & Cache: How prepaid balance works, how same-key top-ups work, how usage deductions, out-of-balance behavior. docs Choose the path once, then stay consistent. Environment Overview: Every supported environment at a glance: which base URL to use, where to paste the key. trust How to Verify CorvusLLM Before You Buy The verification checklist shows how to test CorvusLLM claims, endpoint setup, pricing data, status, legal pages. trust Proof of Operations Proof of Operations collects public evidence assets, published data, operational boundaries. status Checking current status The status page shows customer-facing live checks for website, checkout, customer login, and API compatibility routes. faq Frequently Asked Questions CorvusLLM FAQ and help center with searchable answers about pricing, refunds, delivery, API setup, Cursor, Claude Code. docs Buy, paste, test, and verify your balance in minutes. Quickstart: The shortest safe path from purchase to a working request and a visible balance in the dashboard. models AI Models The CorvusLLM model catalog directory helps users find current customer-facing model families, public slugs, pricing context.
Browse docs
On this page