What is Model aliases?
A model alias is a short name that a gateway resolves to a concrete model, instead of an exact model id.
The best model for a task changes as new ones launch. If your code hardcodes a specific model id, you have to edit and redeploy every time you want to upgrade. An alias decouples intent ('I want the fastest model') from the specific model serving it today.
The trade-off is that behaviour and price move with the target, so production code that must not change under it should pin an exact model id.
How Kyma does it
Kyma does not publish model aliases: you call an exact model id. Kyma never repoints a live model id to another model. On chat completions and messages, if a failover has to serve a different model, X-Kyma-Served-Model names it. Old alias names from earlier versions keep working for existing integrations.