Skip to main content
A client never names a provider URL — it names a model, and TrustGate resolves which registry to use. The model field accepts three forms.

​
Model reference syntax

FormExampleMeaning
Short (pass-through)gpt-4o-miniSent as-is to the selected registry. The load balancer picks among the consumer’s registries.
Provider-qualified@openai/gpt-4oRestrict routing to registries of provider openai, then pick.
Pool referencepool:my-poolRoute via the consumer’s enabled load-balancing pool whose pool_alias matches (case-insensitive), across the pool’s members. Inline routing only.

​
Model policies

Consumers and roles can constrain which models are reachable per registry with model_policies: 
"model_policies": {
  "<registry_id>": {
    "allowed": ["gpt-4o", "gpt-4o-mini"],
    "default": "gpt-4o-mini"
  }
}
  • 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 of allowed.
A request for a model outside the allow-list is rejected before it reaches the provider.

​
Resolution order

  1. Parse the model reference (short / qualified / pool).
  2. Narrow the candidate registries (the consumer’s registry_ids or the pool members, filtered by provider for qualified refs).
  3. Apply model_policies — reject disallowed models; fill in the default when none was given.
  4. Hand the candidates to the load balancer to pick one, with fallback on failure.