Error Quick Reference

Common Errors Quick Reference

Issue Check First Solution
401 / Unauthorized API Key Copy the API Key again. Do not include Bearer when entering the Key in the client.
403 / Forbidden API Key permissions Check the account balance, API Key status, and model restriction list.
404 / Not Found URL path A Base URL should end at /v1. Append /chat/completions only when a full request URL is required.
model_not_found Model ID Copy model.id exactly as shown in the model restriction list or the /v1/models response.
Chat works but Agent does not Tool calling Use a model that supports tool_calls and streaming.
Response stops partway through Streaming output Check streaming/SSE compatibility and network stability.
Duplicate /v1/v1 Automatic client path handling Remove the duplicated path and keep only one /v1.
Request timeout Model/network Test with a shorter prompt, switch to a faster model, and check the proxy or firewall settings.