List Image Models (OpenRouter)
pixara_list_image_modelsBrowse and filter OpenRouter's image-generation models by provider, capability (e.g., transparent backgrounds), and pagination to discover model IDs before generating or editing images.
Instructions
List image-generation models available on OpenRouter, with filtering and pagination.
This is a read-only, no-cost call (no image is generated). Use it to discover model IDs before calling pixara_generate_image or pixara_edit_image, or to find models with a specific capability.
Args:
filter (string, optional): Case-insensitive substring match against model id or name.
provider (string, optional): Restrict to models whose id starts with this prefix, e.g. 'openai', 'black-forest-labs'.
supports_img2img (boolean, optional): Only models that accept input_references.
supports_streaming (boolean, optional): Only models that support SSE streaming.
supports_transparent_background (boolean, optional): Only models supporting transparent backgrounds.
limit (number, 1-100, default 30), offset (number, default 0): Pagination.
response_format ('markdown'|'json', default 'markdown').
Returns: For JSON: { total, count, offset, models: [...], has_more, next_offset? } For Markdown: a heading per model with id, description, and supported parameter names.
Examples:
Use when: "What image models can do transparent backgrounds?" -> supports_transparent_background=true
Use when: "Show me FLUX models" -> filter='flux'
Don't use when: you already know the exact model id (skip straight to generate_image)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of models to return (1-100). | |
| filter | No | Case-insensitive substring match against model id or name. | |
| offset | No | Number of models to skip, for pagination. | |
| provider | No | Filter to models whose id starts with this provider prefix, e.g. 'openai'. | |
| response_format | No | Output format: 'markdown' for humans or 'json' for machine processing. | markdown |
| supports_img2img | No | Only include models that support image-to-image via input_references. | |
| supports_streaming | No | Only include models that support SSE streaming. | |
| supports_transparent_background | No | Only include models that support transparent backgrounds. |