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/api/v1/key.

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

import requests
import json

response = requests.get(
  url="https://api.openroute.cn/api/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
    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 sep), you can make up to FREE_MODEL_RATE_LIMIT_RPM requests per minute. The following per-day limits apply:

• If you have purchased less than FREE_MODEL_CREDITS_THRESHOLD credits, you're limited to FREE_MODEL_NO_CREDITS_RPD sep model requests per day.

• If you purchase at least FREE_MODEL_CREDITS_THRESHOLD credits, your daily limit is increased to FREE_MODEL_HAS_CREDITS_RPD sep 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.