Troubleshooting

This page lists common errors and what they usually mean.

authentication_required

Your request has no valid session or API key.

Check:

• the Authorization header;
• the API key value;
• whether the key was revoked;
• whether you are using the correct base URL.

insufficient_credits

Your account does not have enough credits for the request.

Try:

• reducing prompt size;
• reducing max_tokens;
• waiting for plan renewal;
• upgrading or requesting more credits.

context_window_exceeded

The request exceeds your plan context limit.

Try:

• removing old conversation history;
• summarizing prior context;
• attaching less text;
• using a higher plan.

max_tokens_exceeds_plan_limit

The requested output limit exceeds your plan.

Lower max_tokens or use a plan with a larger output allowance.

unsupported_image_input

The request contains an image input.

Sovereign currently does not expose a vision-capable model. Remove image content and send text instead.

queue_timeout

The request waited too long in the priority queue.

This can happen under load or when your account has reached its active request limit. Retry later or reduce parallel requests.

Provider Errors

If the upstream reasoning layer rejects or fails a request, Sovereign returns a provider error. Retry once. If the issue persists, open a support ticket with:

• approximate time;
• request type;
• model name;
• error code;
• whether the request was streaming;
• a minimal reproduction without secrets.