Skip to main content

​
What groups do

Groups control which models, channels, and pricing rules an API key can use. Different groups can route the same model differently and may have different pricing.

​
Common groups

Choose one or more groups when you create an API key. Current user-visible groups include:
Group names, ratios, and available models follow the console and /api/pricing response. This table is a snapshot of user-visible groups and status, not a permanent price list.

​
Groups and model routing

AIOHub uses the API key group and requested model name to select a matching upstream channel. The same model can have different routing and pricing under different groups.
  • Create a separate API key for each client so you can track usage and limits by tool.
  • If you are unsure which group to use, start with auto, then verify the target client, model, and endpoint with /v1/models and a small request.
  • For Codex CLI, prefer codex or codex-passthrough instead of validating through a generic OpenAI group.
  • Use the console or pricing page to check which models each group currently supports.

​
Notes

Some Claude models are natively configured for 1M context, such as claude-opus-4-7. These models do not need extra configuration for 1M context.For models whose default context is not 1M, such as claude-opus-4-6, choose the opus[1m] model variant in Claude Code when you need the 1M context window. Without the [1m] suffix, Claude Code uses the default shorter context window.
A model’s answer to “what model are you” or “what is your context window” is not reliable. Model names and context limits are assigned after training; the model may not know its serving identifier or runtime limits. Use the client model selector or AIOHub console logs as the source of truth.
Kiro does not natively support PDF input. When you ask Kiro to read a PDF, the client usually tries to call local tools to convert the PDF to text, similar to some desktop chat clients. If the local environment cannot convert the file, the request may fail.If you need direct PDF handling in a conversation, use the claude-bedrock group. AWS Bedrock supports PDF files as native input without an extra local conversion step.