> For the complete documentation index, see [llms.txt](https://docs.qolaba.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qolaba.ai/api-platform/api-platform/image-generation/models.md).

# Models

Retrieve all available image generation models.

## Images — Models API

`GET /api/v1/images/models`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

### Request

No request body or query parameters required.

```http
GET /api/v1/images/models
Authorization: Bearer <YOUR_API_KEY>
```

***

### Response

**`200 OK`**

Returns an object containing a `models` array.

```json
{
  "models": [ ... ]
}
```

#### Model Object

| Field                 | Type       | Description                                                                                             |
| --------------------- | ---------- | ------------------------------------------------------------------------------------------------------- |
| `id`                  | `string`   | Unique model identifier. Use this as the `model` field when calling the generate endpoint.              |
| `name`                | `string`   | Human-readable model name.                                                                              |
| `type`                | `string`   | Always `"image"` for image models.                                                                      |
| `provider`            | `string`   | Internal provider key.                                                                                  |
| `providerName`        | `string`   | Display name of the underlying provider (e.g. `"Google Vertex AI"`).                                    |
| `image`               | `string`   | URL of the provider logo.                                                                               |
| `description`         | `string`   | Summary of the model's strengths and ideal use cases.                                                   |
| `detailedDescription` | `string`   | One-line technical summary.                                                                             |
| `capabilities`        | `string[]` | List of supported capabilities. See Capabilities.                                                       |
| `imageSize`           | `string[]` | Supported aspect ratios (e.g. `"16:9"`, `"1:1"`).                                                       |
| `quality`             | `string[]` | Supported output quality tiers (e.g. `"512"`, `"1K"`, `"2K"`, `"4K"`). Not present on all models.       |
| `quality_pricing`     | `object`   | Cost per image in USD for each quality tier. Keys match the `quality` array. Not present on all models. |
| `outputFormat`        | `string[]` | Supported output MIME types (e.g. `"image/png"`, `"image/jpeg"`). Not present on all models.            |
| `maxNumImages`        | `integer`  | Maximum number of images per request.                                                                   |
| `defaultNumImages`    | `integer`  | Default number of images when `num_images` is not specified.                                            |
| `minTemperature`      | `number`   | Minimum allowed `temperature` value. Not present on all models.                                         |
| `maxTemperature`      | `number`   | Maximum allowed `temperature` value. Not present on all models.                                         |
| `defaultTemperature`  | `number`   | Default `temperature` value. Not present on all models.                                                 |
| `maxReferenceImages`  | `integer`  | Maximum number of reference images per request. Not present on all models.                              |
| `supportsSeed`        | `boolean`  | Whether the model accepts a `seed` for reproducible outputs. Assume `false` if absent.                  |

***

### Capabilities

| Value              | Description                                                             |
| ------------------ | ----------------------------------------------------------------------- |
| `text_to_image`    | Generate an image from a text prompt.                                   |
| `image_to_image`   | Transform or edit an existing image guided by a prompt.                 |
| `reference_images` | Use one or more reference images to guide style or subject consistency. |
| `search_grounding` | Augment generation with real-world search context.                      |

***

### Available Models

| Model ID                   | Name            | Provider         | Capabilities                                                            |
| -------------------------- | --------------- | ---------------- | ----------------------------------------------------------------------- |
| `vertex/nano-banana-flash` | Nano Banana 2   | Google Gemini    | text\_to\_image, image\_to\_image, reference\_images, search\_grounding |
| `vertex/nano-banana-pro`   | Nano Banana Pro | Google Gemini    | text\_to\_image, image\_to\_image, reference\_images                    |
| `vertex/imagen-4`          | Imagen 4        | Google Vertex AI | text\_to\_image                                                         |
| `vertex/imagen-4-fast`     | Imagen 4 Fast   | Google Vertex AI | text\_to\_image                                                         |
| `vertex/imagen-4-ultra`    | Imagen 4 Ultra  | Google Vertex AI | text\_to\_image                                                         |

***

### Error Responses

All errors follow this shape:

```json
{
  "error": {
    "message": "string",
    "type": "string",
    "param": null,
    "code": "string"
  }
}
```

| Status | `code`           | Description                                         |
| ------ | ---------------- | --------------------------------------------------- |
| `500`  | `internal_error` | Unexpected server error.                            |
| `502`  | `upstream_error` | Failed to reach the upstream provider.              |
| `504`  | `timeout`        | Request to upstream provider timed out (30s limit). |

***

## Run the API

To test this API, please use the following link:

{% embed url="<https://app.theneo.io/api-runner/qolaba/ml-apis/api-reference/images-models>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qolaba.ai/api-platform/api-platform/image-generation/models.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.