Limits

Rate Limits and Credits Remaining

To check the rate limit or credits left on an API key, make a GET request to https://openrouter.ai/api/v1/auth/key.

1
const response = await fetch('https://openrouter.ai/api/v1/auth/key', {
2
  method: 'GET',
3
  headers: {
4
    Authorization: 'Bearer {{API_KEY_REF}}',
5
  },
6
});

If you submit a valid API key, you should get a response of the form:

1
type Key = {
2
  data: {
3
    label: string;
4
    usage: number; // Number of credits used
5
    limit: number | null; // Credit limit for the key, or null if unlimited
6
    is_free_tier: boolean; // Whether the user has paid for credits before
7
    rate_limit: {
8
      requests: number; // Number of requests allowed...
9
      interval: string; // in this interval, e.g. "10s"
10
    };
11
  };
12
};

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 :free), you can make up to 20 requests per minute. The following per-day limits apply:

• If you have purchased less than 10 credits, you’re limited to 50 :free model requests per day.

• If you purchase at least 10 credits, your daily limit is increased to 1000 :free model requests per day.

2. 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 402 errors, including for free models. Adding credits to put your balance above zero allows you to use those models again.