# List models

> Every model you can name in a `model` field, with what it accepts and what it costs. Public: no credential required.

`GET /models`

## Response

### 200 — Available models returned

- `data` (required, object[])
  - **image**
    - `displayName` (required, string | null) — Human-readable name as published by the model's creator.
    - `id` (required, string) — Stable model identifier, in `vendor/model` form.
    - `modes` (required, object) — Generation modes the model currently serves, with their input contracts.
      - `img->img` (object)
        - …
      - `txt->img` (object)
        - …
    - `pricing` (required, object | null)
      - `perImage` (required, object)
        - …
      - `perInput` (string) — USD charged per input image supplied with the request.
    - `type` (required, "image")
  - **video**
    - `displayName` (required, string | null) — Human-readable name as published by the model's creator.
    - `id` (required, string) — Stable model identifier, in `vendor/model` form.
    - `modes` (required, object) — Generation modes the model currently serves, with their input contracts.
      - `img->vid` (object)
        - …
      - `txt->vid` (object)
        - …
    - `pricing` (required, object | null)
      - `perSecond` (required, object) — Keyed by resolution tier. A tier the model cannot produce is absent.
        - …
      - `audio` (object) — Present only when audio is billed on top of the per-second video rate.
        - …
    - `type` (required, "video")

```json
{
  "data": [
    {
      "displayName": "string",
      "id": "string",
      "modes": {
        "img->img": {
          "inputs": {
            "rules": null,
            "maxTotal": null
          }
        },
        "txt->img": {
          "inputs": {
            "rules": null,
            "maxTotal": null
          }
        }
      },
      "pricing": {
        "perImage": {
          "base": "string",
          "4k": "string"
        },
        "perInput": "string"
      },
      "type": "image"
    }
  ]
}
```

## Request samples

### cURL

```bash
curl https://api.mynth.io/models
```

### JavaScript

```ts
const response = await fetch("https://api.mynth.io/models", {
  method: "GET",
});

const { data } = await response.json();
```

The full schema for this endpoint is in the [OpenAPI document](https://api.mynth.io/openapi.json).