model field accepts three forms.
Model reference syntax
Model policies
Consumers and roles can constrain which models are reachable per registry withmodel_policies:
allowed— the allow-list of models for that registry. Empty/omitted means all models are permitted.default— used when the request names no model; it must be a member ofallowed.
Resolution order
- Parse the
modelreference (short / qualified / pool). - Narrow the candidate registries (the consumer’s
registry_idsor the pool members, filtered by provider for qualified refs). - Apply
model_policies— reject disallowed models; fill in thedefaultwhen none was given. - Hand the candidates to the load balancer to pick one, with fallback on failure.