troubleshooting · 7 min

API key not working? Diagnose model access and routing

An API key can authenticate while a model request still fails. Identify the failing layer, run the right check and know when a route needs operator attention.

Supesonic · 08.09.2026 · Developer Library

For live models and prices, use the pricing page and marketplace. Dated examples in the Developer Library are planning aids, not quotes.

A newly created API key can authenticate successfully and still fail to run a model. Authentication proves which key was presented; model permissions, routing, account limits and the request format are separate checks.

Locate the failing layer first

Keep the final request URL, HTTP status, error code, message and request identifier. Avoid sharing the authorization header or an unredacted key.

SignalCheck next
Invalid or missing keyIssuing service, authorization header, key state and expiry
Model not allowedExact identifier and key model restrictions
No available channelGroup access and eligible routes
Insufficient balanceRecorded account balance and key allowance
Rate limit / capacityRequest rate, retry policy and current status
Invalid path or parameterFull URL, API family and payload shape

Confirm that the key belongs to this endpoint

Check where you created the key and where your application is sending it. Review enabled state, expiry and usage limit in API keys. Being signed in to the console does not prove the key is valid.

Check balance without confusing it with permissions

A balance message points to a different layer from a permissions failure. Review Wallet and key allowance. If the response reports no eligible route, adding funds will not fix the configuration problem.