Image Models
Endpoint Examples
Image Models
List available image generation and image editing models with capabilities and supported parameters
GET
Image Models
Overview
UseGET /api/v1/image-models to discover the currently available image models and their capabilities. Do not hardcode image model capability tables in your client; model availability and supported parameters can change.
For new integrations using the normalized Image API, prefer GET /api/v1/images/models. That newer route returns model-specific supported_parameters, endpoint metadata links, and input-reference capabilities for use with POST /api/v1/images.
This endpoint is cacheable. Refresh it periodically and handle new fields as additive.
Endpoint
Authentication
Authentication is optional.Authorization: Bearer YOUR_API_KEYx-api-key: YOUR_API_KEY
Query Parameters
Response
Supported Parameters
Supported parameters vary by model. Common fields include:resolutions: array of supported resolution values for this model.max_images: maximum number of images that can be requested at once.rendering_speed: available rendering speed values, when the model exposes speed tiers.fixed_image_count: fixed output count for models that do not allow customn.
supported_parameters.resolutions to populate resolution or size controls. Treat the values as model-specific strings. Most image generation models use pixel dimensions such as 1024x1024, but some models use values such as auto, aspect ratios, quality tiers, or scale factors.
Use the model’s supported_parameters and capabilities objects to decide which controls to show and which request fields to send.
Fields
supported_parameters, including supported_parameters.resolutions, is included only in detailed responses. detailed=true is the default. If you pass detailed=false, each item may include only basic identifiers such as id, object, created, and owned_by.
Example
Notes
- Supported parameters vary by model.
- Use this endpoint instead of hardcoding media model capabilities.
- The response is cacheable, but model availability can change.
- Pricing values are in USD unless otherwise documented in the response.