限制

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

速率限制和剩余信用额度

要检查 API 密钥的速率限制或剩余信用额度，请向 https://www.openroute.cn/api/v1/key 发送 GET 请求。

TypeScript

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

Python

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))

如果您提交有效的 API 密钥，您应该得到以下格式的响应：

TypeScript

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; // 用户之前是否已为信用付费
    // rate_limit: { ... } // 响应中的已弃用对象，可以安全忽略
  };
};

有一些速率限制适用于某些类型的请求，无论账户状态如何：

免费使用限制：如果您使用免费模型变体（ID 以 sep 结尾），您每分钟最多可以发出 FREE_MODEL_RATE_LIMIT_RPM 个请求。以下每日限制适用：

如果您购买的信用额度少于 FREE_MODEL_CREDITS_THRESHOLD，您每天限制为 FREE_MODEL_NO_CREDITS_RPD 个 sep 模型请求。
如果您购买至少 FREE_MODEL_CREDITS_THRESHOLD 个信用额度，您的每日限制增加到 FREE_MODEL_HAS_CREDITS_RPD 个 sep 模型请求。

DDoS 保护：Cloudflare 的 DDoS 保护将阻止大幅超过合理使用的请求。

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

Last updated on

限制

速率限制和剩余信用额度

要检查 API 密钥的速率限制或剩余信用额度，请向 https://www.openroute.cn/api/v1/key 发送 GET 请求。

TypeScript

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

Python

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))

如果您提交有效的 API 密钥，您应该得到以下格式的响应：

TypeScript

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; // 用户之前是否已为信用付费
    // rate_limit: { ... } // 响应中的已弃用对象，可以安全忽略
  };
};

有一些速率限制适用于某些类型的请求，无论账户状态如何：

免费使用限制：如果您使用免费模型变体（ID 以 sep 结尾），您每分钟最多可以发出 FREE_MODEL_RATE_LIMIT_RPM 个请求。以下每日限制适用：

如果您购买的信用额度少于 FREE_MODEL_CREDITS_THRESHOLD，您每天限制为 FREE_MODEL_NO_CREDITS_RPD 个 sep 模型请求。
如果您购买至少 FREE_MODEL_CREDITS_THRESHOLD 个信用额度，您的每日限制增加到 FREE_MODEL_HAS_CREDITS_RPD 个 sep 模型请求。

DDoS 保护：Cloudflare 的 DDoS 保护将阻止大幅超过合理使用的请求。

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

Last updated on