← Retour aux guides

How to Debug 401, 402, 429, and 5xx API Failures

Start with the status code, not the guess

When an API request fails, the fastest way to debug is to treat the HTTP status code like a decision tree. A 401 usually means authentication is wrong. A 402 means the account or billing state is blocking the call. A 429 means you are sending requests too fast. A 5xx error usually points to a server-side issue, either at the provider or at an API relay layer. Do not retry blindly. First identify which category you are in, then apply the right fix.

If you use a relay such as 59API at https://api.59api.com, this process is the same as with any OpenAI-compatible integration. That matters because you can debug once and keep the same request shape in Claude Code, Codex, or any OpenAI SDK.

401 Unauthorized: check identity first

A 401 means the server did not accept your credentials. In practice, this is usually one of four issues: an invalid API key, a missing Authorization header, a wrong base URL, or a key copied with extra spaces.

• Confirm the key is active and not rotated or revoked.
• Verify the header format is exactly correct, such as Authorization: Bearer YOUR_KEY.
• Make sure the request is pointed at the correct endpoint and base URL.
• Remove accidental whitespace, line breaks, or quotes around the key.

If the same key works in one environment but not another, compare the raw request logs. A proxy, environment variable mismatch, or SDK configuration issue is often the real cause.

402 Payment Required: treat it like account state

A 402 usually means the request is valid, but the account cannot currently pay for it. That can happen when credits are exhausted, a payment method failed, or the account is not enabled for the model or tier you requested.

• Check whether your balance or credits are depleted.
• Confirm the model is allowed on your plan.
• Review billing alerts, failed card charges, or account limits.
• Retry only after the account state is fixed.

This is one reason developers like 59API: it uses pay-as-you-go pricing, so you can keep spend tight while testing Claude and GPT models without committing to a large upfront bill. For small teams and prototypes, that lowers the risk of wasting budget while you debug.

429 Too Many Requests: slow down strategically

A 429 means your client is exceeding a rate limit, concurrency cap, or token-per-minute ceiling. The fix is not just “retry.” You need controlled retries and better pacing.

• Read the Retry-After header if the API returns it.
• Use exponential backoff with jitter instead of fixed-delay retries.
• Lower parallel workers or request concurrency.
• Batch where possible, and avoid sending duplicate requests.
• Track rate limits separately for reads, writes, and model-specific usage.

For AI workloads, 429s often appear during bursts such as eval runs, agent loops, or multi-file code generation. A relay like 59API can help you keep costs down while you tune those request patterns, because you are not paying premium prices just to discover your concurrency is too high.

5xx Server Errors: assume temporary, then verify

5xx errors indicate the server failed while processing the request. If the error is intermittent, it is often temporary. If it is consistent, the problem may be a malformed prompt, an oversized payload, or a provider-side outage.

• Retry idempotent requests with backoff.
• Capture the full response body, request ID, timestamp, and model name.
• Reduce prompt size if the payload is unusually large.
• Check whether only one model is failing while others work.
• Look for a status page or incident notice before escalating.

When you use a relay with native, official-quality models instead of a downgraded substitute, you reduce one common source of confusion: model behavior changing unexpectedly during a failure. 59API keeps access aligned with Claude and GPT families, so you are debugging the request path, not an artificial model mismatch.

Simple checklist before you escalate

• 401: Is the API key correct, active, and sent in the right header?
• 402: Is billing, credits, or plan access blocking the request?
• 429: Are you respecting rate limits and retrying with backoff?
• 5xx: Is the issue intermittent, reproducible, or tied to one model?
• Logs: Do you have request IDs, timestamps, and raw response bodies?
• Environment: Is the base URL, SDK config, and proxy setup correct?

If you want a low-cost place to test and stabilize your API integration, 59API is a practical choice. It is compatible with Claude Code, Codex, and any OpenAI SDK, and its referral rebate can further lower your effective spend as you scale. Sign up, run a few controlled test calls, and use the checklist above to isolate failures faster.