# Model catalog API

Source: https://provod.ai/en/docs/catalog

*Model catalog API*

Read the current catalog instead of embedding a historical model list in your code. Generation requests require the exact `id`, not the human-readable name.

```bash
export API_BASE="https://api.provod.ai"
export AI_API_KEY="sk_..."

curl --fail-with-body --silent --show-error \
  "$API_BASE/v1/models?output_modalities=text&supported_parameters=max_tokens&limit=20&offset=0" \
  -H "Authorization: Bearer $AI_API_KEY"
```

Set `API_BASE` to your API origin without `/v1`. The response contains a `data` array. Check availability and supported request formats on the selected entry. A catalog entry does not guarantee live capacity at request time.

| Parameter                               | Purpose                                                                       |
| --------------------------------------- | ----------------------------------------------------------------------------- |
| `q`                                     | Search                                                                        |
| `context`                               | Context                                                                       |
| `input_modalities`, `output_modalities` | Input and output modalities                                                   |
| `model_authors`                         | Model authors                                                                 |
| `supported_parameters`                  | Supported parameters                                                          |
| `sort`                                  | `newest`, `context-high-to-low`, `pricing-high-to-low`, `pricing-low-to-high` |
| `limit`, `offset`                       | Page size 1–1000 and offset                                                   |

`GET /v1/models/count` returns the count for the supplied filters. `GET /v1/model/{author}/{slug}` returns a model card. `GET /v1/models/{author}/{slug}/endpoints` describes its endpoints. URL-encode query values rather than interpolating user input manually.

[Choosing a model](/en/docs/models) · [First request](/en/docs)

## Troubleshooting


**A catalog model rejects the request**


Check the exact ID, availability, supported formats and parameters. Refresh the catalog. Do not silently substitute another model.
