Skip to main content
The model catalog is the routing contract between management and inference. Query the deployed catalog instead of hard-coding the repository snapshot:

Inference model discovery

GET /inf/v1/models returns {"object": "list", "data": [...]}. GET /inf/v1/models/{model_id} returns one model object. Both endpoints require an active workspace inference key and work with the OpenAI SDK’s models.list() and models.retrieve() methods. Model IDs containing slashes are supported. The list is sorted by model ID and contains models from the caller’s organization bundle with a configured credential reference in an eligible platform, organization, or workspace scope. Workspace and selected-key policies apply, including model/provider allowlists, price ceilings, unconditional denials, model-matched denials, and credential-access rules. An unknown or hidden model returns the same 404 response. Missing or invalid inference keys return 401; discovery returns 503 until a bundle is available. Errors use the OpenAI error shape and responses disable caching. Discovery reads the admitted bundle without database queries, provider calls, or secret resolution. It describes configured eligibility, not live credential health. Rules conditioned on streaming or request capabilities, strict parameter checks, request limits, and fallback execution apply during inference. Catalog modalities do not add new inference endpoints; current content support is described below.

Provider entries

The shipped taxonomy currently includes Anthropic, Cerebras, DeepSeek, Fireworks, Groq, Mistral, OpenAI, Together, and xAI provider entries. The deployed catalog is authoritative and may differ after a taxonomy update.

Model entries

Modalities are text, image, audio, video, and pdf. Current inference content supports text, images, and PDFs; catalog entries can still describe the broader vocabulary. Capabilities are streaming, tools, reasoning, and structured_output. airmux derives requirements from the request and rejects a route with a missing capability.

Update the catalog

The repository taxonomy is generated from the model-audit evidence. Apply it to an instance with a dry run first:
Catalog changes publish new bundles for affected organizations. They do not mutate requests already executing on an older snapshot.