跳到主要内容

速率限制

API 速率限制策略。

各计划限制​

计划请求数/分钟突发
沙盒10020
入门500100
商业2,000500
企业自定义自定义

速率限制响应头​

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 450
X-RateLimit-Reset: 1707437460

处理速率限制​

async function withRateLimitRetry<T>(fn: () => Promise<T>): Promise<T> {
  try {
    return await fn();
  } catch (error) {
    if (error.type === 'rate_limit_error') {
      const retryAfter = error.headers?.['retry-after'] || 60;
      await new Promise(r => setTimeout(r, retryAfter * 1000));
      return fn();
    }
    throw error;
  }
}

最佳实践​

  1. 实施退避策略 - 收到 429 后使用指数退避
  2. 缓存响应 - 减少冗余请求
  3. 批量操作 - 使用批量接口
  4. 监控用量 - 跟踪速率限制响应头