For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://modelgates.ai/docs/_mcp/server.
Limits
Making additional accounts or API keys will not affect your rate limits, as we govern capacity globally. We do however have different rate limits for different models, so you can share the load that way if you do run into issues.
Rate Limits and Credits Remaining
To check the rate limit or credits left on an API key, make a GET request to https://modelgates.ai/api/v1/key.
import { ModelGates } from '@modelgates/sdk'; const modelgates = new ModelGates({ apiKey: '{}',}); const keyInfo = await modelgates.apiKeys.getCurrent();console.log(keyInfo);import requestsimport json response = requests.get( url="https://modelgates.ai/api/v1/key", headers={ "Authorization": f"Bearer {{API_KEY_REF}}" }) print(json.dumps(response.json(), indent=2))const response = await fetch('https://modelgates.ai/api/v1/key', { method: 'GET', headers: { Authorization: 'Bearer {{API_KEY_REF}}', },}); const keyInfo = await response.json();console.log(keyInfo);If you submit a valid API key, you should get a response of the form:
type Key = { data: { label: string; limit: number | null; // Credit limit for the key, or null if unlimited limit_reset: string | null; // Type of limit reset for the key, or null if never resets limit_remaining: number | null; // Remaining credits for the key, or null if unlimited include_byok_in_limit: boolean; // Whether to include external BYOK usage in the credit limit usage: number; // Number of credits used (all time) usage_daily: number; // Number of credits used (current UTC day) usage_weekly: number; // ... (current UTC week, starting Monday) usage_monthly: number; // ... (current UTC month) byok_usage: number; // Same for external BYOK usage byok_usage_daily: number; byok_usage_weekly: number; byok_usage_monthly: number; is_free_tier: boolean; // Whether the user has paid for credits before // rate_limit: { ... } // A deprecated object in the response, safe to ignore };};There are a few rate limits that apply to certain types of requests, regardless of account status:
- Free usage limits: If you're using a free model variant (with an ID ending in ), you can make up to requests per minute. The following per-day limits apply:
-
If you have purchased less than credits, you're limited to model requests per day.
-
If you purchase at least credits, your daily limit is increased to model requests per day.
- DDoS protection: Cloudflare's DDoS protection will block requests that dramatically exceed reasonable usage.
If your account has a negative credit balance, you may see errors, including for free models. Adding credits to put your balance above zero allows you to use those models again.