Open Model Gatewaydocs

Catalogs

Group approved models into catalogs, choose default catalogs for each kind of workspace, and replace them for one workspace.

A catalog is a named list of approved models. Catalogs decide which models each workspace may add; the workspace's owner or admin then adds the ones it uses.

Examples

Catalogs are yours to define. Example University might have:

CatalogModelsDefault for
Self-hostedModels on the university's own GPU serversPersonal, Team, Project
Approved cloudSelected cloud models under a data agreementTeam, Project
Advanced cloudLarger, costlier cloud models(none: chosen per workspace)

Create a catalog

Create catalog with a name and description, then add models on its Models tab. A catalog's page also shows Who gets it (the workspace types whose defaults include it, and the workspaces that chose it themselves) and Settings.

You can also set a model's catalogs from the model's own page, under Availability.

Defaults per workspace type

Defaults is a matrix of catalogs against Personal, Team and Project. Every workspace of that type without its own choice gets exactly those catalogs, and follows changes at once.

A new personal workspace, Team or Project whose type has no default catalog starts with no models. The setup checklist reminds you.

Replace them for one workspace

On a Team's or Project's page in Admin, under Models, you can replace its catalogs with your own choice. A replacement:

  • replaces the type's defaults, it doesn't add to them;
  • can be empty, which means no catalog models at all (direct assignments still work);
  • no longer follows changes to the defaults, until you reset it.

Direct assignments

A Platform Admin can assign a model to one workspace directly, outside any catalog, for exceptions. Direct assignments are independent: losing a catalog doesn't remove them, and removing one doesn't touch catalog access.

What happens when access is removed

When a model leaves a catalog, or a catalog stops being available to a workspace, the workspace loses the models it added from it, unless another available catalog or a direct assignment still covers them.

  • Keys restricted to such a model lose it too. A key whose models are all removed can't use any model; it never turns into an unrestricted key.
  • Selections removed this way don't come back if the model returns later. The workspace's admin adds the model again, and keys that should use it must be re-created.
  • Requests already running may finish.

Catalogs are availability, not permission

Being in a catalog is not enough to use a model. The workspace must add it, the model and a route must be enabled, and the key must allow it. Settings › Access in each workspace explains which of these is missing.

On this page