Skip to main content
GET
Image Models

Overview

Use GET /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_KEY
  • x-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 custom n.
Use 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.