Find a model

Use Bildomat’s local catalog to find a model and inspect its accepted options. These commands do not contact generation services or require provider credentials.

Narrow the catalog

shell
bild list --models --image
bild list --models --video
bild search flux --models

--models prints fully qualified identifiers that you can use in scripts. --providers lists the providers that own the selected models. With neither selector, or both, Bildomat groups models under providers. The image/video pair works the same way: neither or both includes both media types. Add --aliases to show each model's aliases; listings omit them otherwise.

Ordinary search ignores case and matches the start of each slash-delimited part of a model key and each alias. Search matches aliases even when --aliases is not given, so a result can match through an alias that the listing does not show. Use a regular expression to match elsewhere in a name, or across the slash between a provider and a model; a plain term containing a slash matches nothing:

shell
bild search --regex 'image-(1|2)' --models
bild search --regex 'google/gemini' --models

Regular expressions use RE2 syntax and are case-sensitive unless the expression changes that. More than 100 matches for a search term is an error; narrow the term or add a media filter.

Remove models you do not want with --exclude, beside a search term or on its own:

shell
bild search --models kling --exclude kling-2
bild search --models --exclude openrouter

An exclusion term matches the way a search term does, so plain text removes only models whose key part or alias begins with it. Use --regex to remove by any part of a name; both terms are then expressions:

shell
bild search --models kling --regex --exclude 'turbo|omni'

An exclusion used without a search term has no match limit, so it can pare down the whole catalog.

Inspect the result

shell
bild info google/gemini-3.1-flash-image
bild info google --video

A model page shows its aliases, accepted options, required values, bounds, input count, and special rules. A provider page compares the options of its models. The aggregator OpenRouter receives a summary in text output instead; --json still returns its full selected model details.

Media filters narrow a provider page. They do not hide a model that you name explicitly.

Select the model

Use a fully qualified identifier when the provider matters:

shell
bild --model openai/gpt-image-2 --output-path ./poster.png "A geometric travel poster for a coastal railway"

openai/gpt-image-2 and openrouter/openai/gpt-image-2 use different providers and credentials. They can expose different options even when their names describe the same underlying model. Aliases and model identifiers are case-sensitive; search is more permissive.

Set the selected provider’s credential using configuration or its environment variable. See model specifiers for exact lookup and ambiguity rules.

For machine-readable discovery:

shell
bild search --json --video veo
bild info google/veo-3.1-generate-preview --json

The provider reference lists the full documented catalog.

Bildomat 0.0.7Revised 2026-10-01