---
title: List image models
description: Every model the Image Router runs, with what it accepts and what it costs.
---
`GET` `/v1/image-router/models`

**Host** `https://api.open.sume.com` · **Auth** API key

Returns every image model you can name in [Generate an image](/docs/reference/images/generate). Each row says what the model accepts in `capabilities` and lists its limits in `constraints`. `pricing` is in Sume credits; dollar prices for open.sume.com keys are in [List open models](/docs/reference/catalog/list).

## Request

### Headers

| Header | Type | Required | Description |
|---|---|---|---|
| `Authorization` | string | Yes | `Bearer <key>`. Or send `x-api-key`. |

## Example

<!-- api-call-example:v2-image-models -->

## Response

`200 OK`

```json
{
  "data": {
    "models": [
      {
        "id": "gpt-image-2",
        "name": "ChatGPT Image 2",
        "modality": "image",
        "routing": "pass_through",
        "capabilities": {
          "text_to_image": true,
          "image_edit": true,
          "aspect_ratios": [
            "auto",
            "1:1",
            "16:9",
            "9:16",
            "4:3",
            "3:4",
            "5:4",
            "9:8",
            "4:5"
          ],
          "resolutions": [],
          "qualities": [
            "low",
            "medium",
            "high"
          ],
          "max_images": 4,
          "output_formats": [
            "png",
            "jpeg",
            "webp"
          ]
        },
        "pricing": {
          "basis": "per_image",
          "credits_per_image": 17.4
        },
        "constraints": [
          "Admit uses an image-token estimate (quality + size); the listed rate is high quality at 1024"
        ]
      },
      "…"
    ]
  }
}
```

## Errors

| Status | `code` | When |
|---|---|---|
| 401 | `unauthorized` | No key, or the key is wrong or revoked. |
| 429 | `rate_limited` | Too many requests for your key in this window. |

[All error codes](/docs/errors)

## Related

- [Get an image model](/docs/reference/images/get-model)
- [Generate an image](/docs/reference/images/generate)