---
title: "List image models"
method: GET
path: "/image/models"
tags: ["Images"]
---

# List image models

`GET /image/models`

## Request

- Base URL: `https://api.wondercraft.ai/v1`
- URL: `https://api.wondercraft.ai/v1/image/models`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/wondercraft/apis/wondercraft-public-api/docs/image/models/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the image models available through the API, with the resolutions, aspect ratios and
credits per image each one supports. Requires a valid `X-API-KEY` header.

## Response `200`

Successful Response

- ListImageModelsResponse
  - `models` ApiImageModel[], required: Image models available through the API
    - `id` string, required: Model ID to pass as `model_id` when generating
    - `title` string, required: Display name of the model
    - `description` string, required: What the model is good at
    - `resolutions` ApiResolution[], required: Output resolutions this model supports
    - `default_resolution` '480p' | '720p' | '1080p' | '2k' | '4k', required: Output resolution shared by the image and video APIs; each model lists the values it supports.
    - `aspect_ratios` ApiAspectRatio[], required: Aspect ratios this model supports
    - `supports_reference_images` boolean, required: Whether `reference_image_ids` can be sent
    - `max_reference_images` integer, nullable: Maximum number of reference images, or null when the model sets no limit
    - `credits_by_resolution` object, required: Credits charged per generated image at each supported resolution

## Changes

- **2026-10-16** `200f24d7f14b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/changes/image/models/get.md)

---

[API](https://skmtc.dev/wondercraft/apis/wondercraft-public-api.md) - [All operations](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wondercraft/apis/wondercraft-public-api/revisions/200f24d7f14b?raw)