Documentation Index
Fetch the complete documentation index at: https://docs.nano-gpt.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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
| Parameter | Type | Default | Description |
|---|---|---|---|
detailed | boolean | true | Include names, descriptions, pricing, capabilities, and supported 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
| Field | Type | Description |
|---|---|---|
id | string | Model ID to pass to image generation or image editing endpoints. |
object | string | Always model. |
created | integer | Unix timestamp derived from the model’s added date. |
owned_by | string | Provider or owner identifier. |
name | string | Human-readable model name. |
description | string | Short model description. |
architecture | object | Modality metadata, including input and output modalities. |
pricing | object | USD pricing metadata. Shape can vary by model. |
capabilities | object | Feature flags such as image_generation, image_to_image, and inpainting. |
capabilities.nsfw | boolean | Whether the model is uncensored / NSFW-capable. |
supported_parameters | object | Model-specific parameters such as sizes, counts, quality settings, seeds, or image input controls. |
supported_parameters.resolutions | string[] | Model-specific supported output resolution values. Usually pixel dimensions like 1024x1024; may also be symbolic values such as auto or model-specific scale factors. |
supported_parameters.max_images | integer | Maximum number of images the model supports per request. |
supported_parameters.rendering_speed | string[] | Optional list of rendering speed tiers. Present only for models that expose speed choices. |
supported_parameters.fixed_image_count | integer | Optional fixed output image count. Present when the model always returns a fixed number of images. |
icon_url | string | Optional provider icon path. |
tags | string[] | Optional model tags. |
category | string | Model category. Usually image. |
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.