Account Model Rules
Version: v1.0.0+ Updated: 2024-02-13
Overview
Account Model Rules allow you to specify which models each OAuth account can access. This feature is useful for:
- Restricting specific accounts to only access certain models
- Preventing accounts from using unsupported models that cause request failures
- Assigning different model permissions to different accounts
Opening Configuration
- Go to the Providers page
- Next to an added OAuth account, click the model rules icon (usually a gear or filter icon)
- Open the Account Model Rules modal
Configuration Methods
Select from Model List
The modal automatically loads available models from the current proxy (filtered by provider). Click any model to add it to the rules.
Manual Input
Enter a model name or pattern in the search box, then press Enter or click the add button.
Pattern Matching Syntax
Account model rules support wildcard pattern matching:
| Pattern | Description | Example |
|---|---|---|
| Exact match | Complete model name | gemini-2.5-pro |
| Prefix match | Ends with * | gemini-2.5-* matches all models starting with gemini-2.5 |
| Suffix match | Starts with * | *-preview matches all models ending with preview |
| Contains match | * on both ends | *flash* matches all models containing flash |
Configuration Examples
Only Allow Pro Models
gemini-2.5-pro
gemini-2.0-pro
claude-3-5-sonnet*Allow All Flash Models
*flash*Exclude Preview Models (Only Allow Stable)
gemini-2.5-pro
gemini-2.0-flash
claude-3-5-sonnet-20241022Source Key
For some providers (like Gemini), there may be multiple source options:
| Provider | Source Options |
|---|---|
| Gemini | gemini-cli, vertex, aistudio |
| Claude | claude |
| Codex | codex |
| Copilot | copilot |
| Kiro | kiro |
Select the correct Source Key to ensure rules apply to the correct upstream service.
Saving Rules
- Add all required model patterns
- Ensure at least one pattern exists (cannot be empty)
- Click the Save button
After saving, requests from this account will only work with models matching the rules.
Deleting Rules
To remove a pattern, click the X button next to it.
To clear all rules (allow access to all models), delete all patterns and save.
Common Issues
Rules not taking effect
- Ensure proxy service is running
- Check if Source Key is correct
- Try re-saving the rules
Requests being rejected
If the requested model is not in the rules list, the proxy will reject the request. Check if rules correctly include the needed models.
Model list is empty
- Ensure proxy service is running
- Click refresh to reload
- Check network connection