Limits

速率限制和剩余积分

原文链接：https://openrouter.ai/docs/api/reference/limits

速率限制和剩余积分

要检查 API key 上的速率限制或剩余积分，请向 https://openrouter.ai/api/v1/key 发出 GET 请求。

import { OpenRouter } from '@openrouter/sdk';

const openRouter = new OpenRouter({
  apiKey: '<OPENROUTER_API_KEY>',
});

const keyInfo = await openRouter.apiKeys.getCurrent();
console.log(keyInfo);

如果你提交有效的 API key，你应该得到如下形式的响应：

type Key = {
  data: {
    label: string;
    limit: number | null; // 密钥的信用限制，如果无限则为 null
    limit_reset: string | null; // 密钥的限额重置类型，如果不重置则为 null
    limit_remaining: number | null; // 密钥的剩余积分，如果无限则为 null
    include_byok_in_limit: boolean; // 是否在信用限制中包含外部 BYOK 使用

    usage: number; // 使用的积分（全部时间）
    usage_daily: number; // 使用的积分（当前 UTC 日）
    usage_weekly: number; // ...（当前 UTC 周，从星期一开始）
    usage_monthly: number; // ...（当前 UTC 月）

    byok_usage: number; // 外部 BYOK 使用的相同信息
    byok_usage_daily: number;
    byok_usage_weekly: number;
    byok_usage_monthly: number;

    is_free_tier: boolean; // 用户是否已购买积分
  };
};

速率限制

创建额外的账户或 API keys 不会影响你的速率限制，因为我们全局管理容量。但是，我们对不同的模型有不同的速率限制，因此如果你遇到问题，可以通过这种方式分担负载。

免费使用限制

如果你使用的是免费模型变体（ID 以 :free 结尾），则每分钟最多可以发出 20 个请求。以下每日限制适用：

• 如果你购买的积分少于 10，你每天被限制 50 个 :free 模型请求。
• 如果你购买至少 10 个积分，你的每日限制增加到每天 1000 个 :free 模型请求。

DDoS 保护

Cloudflare 的 DDoS 保护将阻止严重超过合理使用的请求。

负余额

如果你的账户有负信用余额，你可能会看到 402 错误，包括免费模型。添加积分以使你的余额高于零，这样你就可以再次使用这些模型。