---
title: Get an image model
description: One Image Router model by id.
---
`GET` `/v1/image-router/models/{model_id}`

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

Returns one image model: what it accepts and its limits. `pricing` is in Sume credits; your open.sume.com key is charged in dollars, listed in [Get an open model](/docs/reference/catalog/get).

## Request

### Headers

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

### Path

| Name | Type | Required | Description |
|---|---|---|---|
| `model_id` | string | Yes | A model id from the router's list. |

## Example

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

## Response

`200 OK`

```json
{
  "data": {
    "model": {
      "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. |
| 404 | `not_found` | No model with that id on this router. |
| 429 | `rate_limited` | Too many requests for your key in this window. |

[All error codes](/docs/errors)

## Related

- [List image models](/docs/reference/images/list-models)