Skip to content

List available models

GET
/v1/models

Returns all available AI models with their capabilities. Each model entry tells you which operations it supports (generate, edit, combine), accepted aspect ratios and sizes, output formats, approximate cost, and whether it supports multi-turn story generation.

Use the model’s id field as the model parameter in generation requests. Some models have aliases (shorter names) that also work.

OK

object
cached_at

UTC timestamp when the model list was last refreshed from cache.

string format: date-time
disclaimer

Disclaimer noting that listed prices are estimates; actual per-generation cost and prices over time may vary.

string
models

List of available models.

array | null
object
approximate_cost_eur

Approximate cost per generation in EUR. Estimate only; actual per-generation cost may vary.

string
aspect_ratios

Supported aspect ratios (e.g. 1:1, 16:9). Empty when image_sizes is used.

array | null
can_edit

Whether the model supports image editing (inpainting / instruction-based edit).

boolean
can_generate

Whether the model supports text-to-image generation.

boolean
description

Brief description of the model’s strengths and recommended use cases.

string
fixed_sizes

Supported fixed pixel dimensions (e.g. 1024x1024). Empty if not applicable.

array | null
id

Unique model identifier used in generation requests.

string
image_sizes

Supported named image sizes (e.g. square_hd). Empty when aspect_ratios is used.

array | null
max_characters

Maximum number of named characters for story generation. 0 when not applicable.

integer
max_combine_inputs

Maximum number of input images accepted by this model for combine operations. 0 when no model-specific cap is known (only the API-wide 5-image cap applies).

integer
name

Human-readable model name.

string
operations

Operations this model supports (generate, edit, combine).

array | null
output_formats

Supported output image formats.

array | null
supports_multiturn

Whether the model supports multi-turn story generation.

boolean

Bad Request

object
details
error
string
message
string
request_id
string

Unauthorized

object
details
error
string
message
string
request_id
string

Payment Required

object
details
error
string
message
string
request_id
string

Forbidden

object
details
error
string
message
string
request_id
string

Not Found

object
details
error
string
message
string
request_id
string

Conflict

object
details
error
string
message
string
request_id
string

Unprocessable Entity

object
details
error
string
message
string
request_id
string

Too Many Requests

object
details
error
string
message
string
request_id
string

Unavailable For Legal Reasons

object
details
error
string
message
string
request_id
string

Internal Server Error

object
details
error
string
message
string
request_id
string

Bad Gateway

object
details
error
string
message
string
request_id
string

Service Unavailable

object
details
error
string
message
string
request_id
string