# Models

> List available Raywake AI models and read their input schemas. Explore model IDs, categories and the parameters required to generate media.

Canonical: https://raywake.si/docs/reference/models
Last updated: 2026-10-02

## List models

`GET /v1/models`

Models ready to use, in catalog order. Requires `models:read`.

**Query parameters**

| Name | Type | Description |
| --- | --- | --- |
| `search` | string | Match name, description or model id. |
| `category` | string | A task such as `text-to-image`; see `GET /v1/models/categories`. |
| `grouped` | boolean | Return one entry per product with its modes (for example text-to-image and edit) instead of one per model id. Default: `false`. |
| `limit` | integer | Page size, up to 500. Default: `100`. |
| `offset` | integer | Items to skip. Default: `0`. |

**Example**

cURL:

```bash
curl -s https://api.raywake.com/v1/models?category=text-to-image&limit=20 \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"
```

Python:

```python
import json, os, requests

response = requests.get(
    "https://api.raywake.com/v1/models?category=text-to-image&limit=20",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"},
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/models?category=text-to-image&limit=20", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}` },
});
console.log(await response.json());
```

## Get a model

`GET /v1/models/{model}`

The model's details and its input schema under `openapi` (an OpenAPI document with one request body). Model ids contain slashes; use them as-is in the path.

**Example**

cURL:

```bash
curl -s https://api.raywake.com/v1/models/nano-banana-pro \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"
```

Python:

```python
import json, os, requests

response = requests.get(
    "https://api.raywake.com/v1/models/nano-banana-pro",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"},
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/models/nano-banana-pro", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}` },
});
console.log(await response.json());
```

## Categories

`GET /v1/models/categories`

The task categories present in the catalog.

## Related

- [API documentation](https://raywake.si/docs)
