Groups & Multipliers (Auto-A)

Every API token belongs to one or more groups. A group defines which models the token may call and which upstream channel routing (and cost) applies.

What is a Group Multiplier?Copy Anchor Link

When a request is processed, the deducted balance is computed as:

Effective Cost = Base Model Rate × Model Ratio × Group Multiplier

Groups with different multipliers route through channels with different pricing — lower multipliers are cheaper per token, higher ones use premium routing. The multiplier each group applies to every model is shown on the /pricing page.

The Automatic Group: Auto-ACopy Anchor Link

When you create a token you will see a group selector in the form. Auto-A is the automatic routing group and the recommended choice for almost every use case:

1. Universal coverage: Auto-A is enabled for the models in the catalog, so one token can call the whole gateway without juggling groups.
2. Automatic routing: requests are routed automatically across available upstream channels — you don't manage channel selection.
3. Zero configuration: pick Auto-A and your token works with any model whose Enabled Groups column includes it.

Recommendation: for the vast majority of setups, select Auto-A when creating or editing a key in the API Keys section (sidebar → Console → API Keys, at https://api.nyxos.shop/keys). Only choose a different group if you have a specific routing or cost reason.

Verifying Group AccessCopy Anchor Link

1. Open the /pricing page and find your model.
2. Check the Enabled Groups column.
3. Make sure your key is assigned to one of those groups (API Keys → Edit).
4. If the model is not available in your group, calls fail with 404 / permission errors — see Troubleshooting.