Model Gateway errors

These are errors from calling models through Atlan Model Gateway. Start from the status code or symptom you see: each section below starts from one of them.

​

401

A model call returns 401.

​

Cause

The key is missing, mistyped, or revoked.

​

Solution

1. Check that ATLAN_API_KEY is set in the shell that runs the client.
2. Run GET /models again and confirm the model is listed.

---

​

404 with not_found

A model call returns 404 with not_found.

​

Cause

The model is not one you can route to, or the operation is not served.

​

Solution

1. Copy the id exactly from GET /models, and check Supported operations.
2. Run GET /models again and confirm the model is listed.

---

​

400 with invalid_request

A model call returns 400 with invalid_request.

​

Cause

The request does not fit the model, such as an embedding model on chat completions, or it uses a field the gateway refuses.

​

Solution

1. Check the model’s modality in GET /models, and the fields under Supported operations.
2. Make the call again and confirm it returns a model reply.

---

​

400 with model_request_unsupported

An image generation returns 400 with model_request_unsupported.

​

Cause

The request named a field a Gemini image model on a Vertex provider can’t honor, such as response_format: url or background: transparent. The error names the field.

​

Solution

1. Remove the named field, or change it to a value the model serves, as Supported operations describes.
2. Make the call again and confirm it returns an image.

---

​

503 with service_unavailable

A model call returns 503 with service_unavailable.

​

Cause

The model’s provider is unavailable.

​

Solution

1. Retry later, or pick a model from another provider.
2. Make the call again and confirm it returns a model reply.

---

​

429

A model call returns 429.

​

Cause

A budget or rate limit refused the call.

​

Solution

1. The error names the limit that refused it.
2. Ask your admin to raise it, or wait for the window to reset.
3. Make the call again and confirm it returns a model reply.

---

​

Model missing from GET /models

A model is missing from GET /models.

​

Cause

Its provider or the model is disabled, or it is not in your workspace.

​

Solution

1. Ask your admin to enable it.
2. Run GET /models again and confirm the model is listed.

---

​

See also

• Connect client to Model Gateway: Base URLs, models, and supported operations.
• AI Gateway: How the gateways fit together.

​

Need help

If you need assistance after trying these steps, contact Atlan support.