> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prismgateway.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Models

> Discover models and understand organization and key filtering

# Models

Always discover model IDs with the same API key that will make the request:

```bash theme={null}
curl -sS "https://api.prismgateway.io/v1/models" \
  -H "Authorization: Bearer $PRISM_API_KEY"
```

The response uses the OpenAI model-list shape. A key sees the intersection of:

* models currently published in the Prism catalog
* models enabled for its organization
* the key's route scopes and model allowlist
* the welcome-credit trial allowlist, while the key owner is in trial

Do not hard-code a provider's private upstream model ID. Send the public model
ID returned by Prism.

## Route compatibility

| Modality       | Endpoint                            |
| -------------- | ----------------------------------- |
| Chat           | `POST /v1/chat/completions`         |
| Embeddings     | `POST /v1/embeddings`               |
| Images         | `POST /v1/images/generations`       |
| Video creation | `POST /v1/video/generations`        |
| Video status   | `GET /v1/video/generations/{jobId}` |

If a model is not valid for the requested route, Prism returns a `4xx` catalog
or policy error. Refresh `/v1/models` before falling back to a different model.

## Trial catalog

`GET /v1/trial-policy` is public and returns the current sorted chat allowlist,
unlock threshold, and a stable `policy_hash`. Trial keys see only the permitted
chat models in `/v1/models`.

[อ่านภาษาไทย](/th/models)