Troubleshooting

Cline API Errors — API Request Failed, 401, 429, Context Limit

Cline shows most failures as an "API Request Failed" banner with the provider's response underneath. The banner itself is not the diagnosis — the status and error.type in the body are. The pages below map each body to its fix.

ErrorMeaning
API Request FailedCline's API Request Failed banner is a wrapper around the provider's response. How to read the status and error.type underneath and route yourself to the actual fix.
{"error":{"message":"Invalid or missing API key.","type":"invali…Cline returns 401 when the OpenAI-compatible endpoint rejects the key: wrong base URL field, whitespace in the key, or a revoked key. The fix checklist.
{"error":{"message":"Rate limit reached. Please retry shortly.",…Cline agent runs send requests back to back and then loop on 429 retries. Why agent workloads reach the account's rate ceiling and how to get a run through.
{"error":{"message":"This model's maximum context length was exc…The 400 context_length_exceeded appears when Cline's accumulated task context no longer fits the selected model's window. How to recover and keep the next task inside the limit.

Cline API Request Failed — Diagnosing the Real Error

Cline's API Request Failed banner is a wrapper around the provider's response. How to read the status and error.type underneath and route yourself to the actual fix.

Cline 401 Invalid API Key (OpenAI Compatible) — Fix

Cline returns 401 when the OpenAI-compatible endpoint rejects the key: wrong base URL field, whitespace in the key, or a revoked key. The fix checklist.

Cline 429 rate_limit_error — Stop the Retry Loop

Cline agent runs send requests back to back and then loop on 429 retries. Why agent workloads reach the account's rate ceiling and how to get a run through.

Cline: maximum context length exceeded (context_length_exceeded) — Fix

The 400 context_length_exceeded appears when Cline's accumulated task context no longer fits the selected model's window. How to recover and keep the next task inside the limit.

Skip the broken setup

apiToken.sale serves GPT and Gemini models through OpenAI-compatible, Messages (Anthropic format) and native Gemini endpoints — standard SDKs, one key, one prepaid balance. Point your tool's base URL at it, and the config on this page works as written.