Limits

Rate Limits and Credits Remaining

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

const response = await fetch('https://api.openroute.cn/v1/key', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer {{API_KEY_REF}}',
  },
});

import requests
import json

response = requests.get(
  url="https://api.openroute.cn/v1/key",
  headers={
    "Authorization": f"Bearer {{API_KEY_REF}}"
  }
)

print(json.dumps(response.json(), indent=2))

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

    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)

    is_free_tier: boolean; // Whether the user has paid for credits before
  };
};

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 30 requests per minute. The following per-day limits apply:

• If you have purchased less than 1000 credits, you're limited to 100 :free model requests per day.

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

2. DDoS protection: 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.