Core concepts
Model aliases
Your names for models, not the provider's.
Your customers call acme/smart, not anthropic/claude-sonnet-4. The alias is the indirection that lets you change provider, change model, or run a fallback without your customers noticing or your prices moving.
text
What an end user sees
Aliases only. Usage rows, the portal and every invoice show your name for the model, which provider served a call never crosses that boundary.
This is enforced at the response boundary, not by convention. A usage row that leaked a provider model id would be the bug this indirection exists to prevent.