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.

typescript
import { ModelGates } from '@modelgates/sdk'; const modelgates = new ModelGates({  apiKey: '{}',}); const keyInfo = await modelgates.apiKeys.getCurrent();console.log(keyInfo);
python
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))
typescript
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:

typescript
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:

  1. 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.

  1. 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.