Troubleshooting

Zed Assistant Errors — 401, 429, Custom api_url

Zed's assistant passes the endpoint's responses through nearly verbatim, so the error text you see is the API's own. What is specific to Zed is where the key, the custom api_url and the model list live in settings.json — most persistent failures trace back to those fields.

ErrorMeaning
{"error":{"message":"Invalid or missing API key.","type":"invali…Zed's assistant passes the endpoint's 401 through verbatim. Where the key and api_url of the OpenAI provider live in Zed and why they must come from the same issuer.
{"error":{"message":"Rate limit reached. Please retry shortly.",…A 429 in Zed's assistant is the rate or concurrency ceiling of the account behind your key. Why agent threads and shared keys trigger it and what clears it.
zed custom openai api urlHow to point Zed's OpenAI provider at a custom endpoint with language_models.openai.api_url, and why a missing /v1 or an unlisted model id produces 404s.

Zed 401 Invalid API Key — OpenAI Provider Settings Fix

Zed's assistant passes the endpoint's 401 through verbatim. Where the key and api_url of the OpenAI provider live in Zed and why they must come from the same issuer.

Zed Assistant 429 rate_limit_error — Fix

A 429 in Zed's assistant is the rate or concurrency ceiling of the account behind your key. Why agent threads and shared keys trigger it and what clears it.

Zed api_url for OpenAI-Compatible Models — Custom Base URL and the 404

How to point Zed's OpenAI provider at a custom endpoint with language_models.openai.api_url, and why a missing /v1 or an unlisted model id produces 404s.

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.