Routing
Model aliases
Latest-model aliases and catalog mappings
Model aliases
Yaha resolves latest-model aliases before allowlist checks:
| Alias pattern | Example | Behavior |
|---|---|---|
provider/family-latest | openai/gpt-latest | Newest active catalog model matching the family |
~provider/family-latest | ~anthropic/claude-sonnet-latest | Same (tilde prefix ignored) |
Superadmin catalog aliases
Platform operators can define explicit mappings in model_aliases (API: GET/POST/PATCH /v1/admin/platform/model-aliases). Aliases sync to the gateway catalog snapshot on refresh.
Examples
{
"model": "~openai/gpt-latest",
"messages": [{ "role": "user", "content": "Hello" }]
}The resolved concrete model must still appear on your project allowlist.