--- title: 速率限制 url: https://platform.claude.com/docs/zh-TW/api/rate-limits description: 為了減少濫用並管理 API 的容量，我們對組織可使用 Claude API 的程度設有限制。 --- **[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)：** 本頁的速率限制適用於 Claude Platform on AWS，但計費與限制管理方式有所不同。計費透過 AWS Marketplace 進行（而非購買 Anthropic 額度）。Claude Platform on AWS 上的組織會被歸入 Start 層級，並可隨著累積已付款的 AWS Marketplace 發票紀錄而自動升級至更高層級。若要申請更高的限制，請聯繫您的 Anthropic 客戶代表或 [Anthropic 支援](https://support.claude.com)；**申請提高層級**流程無法使用。Claude Platform on AWS 不提供每個工作區的速率限制設定及 [fast mode](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode)（快速模式）。詳情請參閱 [Claude Platform on AWS 的速率限制與配額](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)。 限制分為兩種類型： 1. **Spend limits**（支出限制）設定組織每月因 API 使用而可產生的最高費用。 2. **Rate limits**（速率限制）設定組織在特定時間內可發出的 API 請求數量上限。 API 會在組織層級強制執行服務設定的限制，但您也可以為組織的工作區設定使用者可配置的限制。 ## 關於速率限制 * 限制的設計目的在於防止 API 濫用，同時將對一般客戶使用模式的影響降到最低。 * 限制依 **usage tier**（使用層級）定義。組織會根據使用歷史與帳戶狀況自動被置於某個層級，並可隨著使用 API 的時間推移而升至更高層級。 * 新組織以及使用歷史有限的組織可能會從評估層級開始，在建立帳戶歷史期間，其限制會低於本頁所示的標準限制。這些起始限制是 Anthropic 防止詐欺與濫用的措施之一，並會隨著您的組織累積使用歷史而自動提高。 * 限制設定於組織層級。您可以在 [Claude Console](https://platform.claude.com/) 的[速率限制](https://platform.claude.com/usage/limits)頁面（`platform.claude.com/usage/limits`）查看組織的層級與目前的限制。 * 您可能會在較短的時間間隔內觸及速率限制。例如，每分鐘 60 次請求（RPM）的速率可能會以每秒 1 次請求的方式強制執行。短時間內的大量請求可能會超出限制並觸發速率限制錯誤。 * 以下限制為各層級的標準限制。若您需要更高的限制，請參閱[申請更高的限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#requesting-higher-limits)。 * API 使用 [token bucket algorithm](https://en.wikipedia.org/wiki/Token_bucket)（權杖桶演算法）進行速率限制。這表示您的容量會持續補充至上限，而非在固定間隔重設。 * 此處描述的所有限制代表允許的最大使用量，而非保證的最低值。這些限制旨在減少非預期的超支，並確保資源在使用者之間公平分配。 ## 支出限制 **[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)：** 適用相同的每月支出上限，且請求在達到上限時會以相同方式停止。計費與層級提升的運作方式不同；請參閱 [Claude Platform on AWS 的支出限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#spend-limits)。 Start、Build 和 Scale 層級各有一個每月支出上限，即您的組織每個日曆月在 API 上可支出的最高金額。您可以在 Claude Console 的[帳單](https://platform.claude.com/settings/billing)頁面查看組織的每月支出上限，並設定您自己的限制。 | 使用層級 | 每月支出上限 | | ----- | ------------ | | Start | $500 USD | | Build | $1,000 USD | | Scale | $200,000 USD | 自訂層級的組織沒有每月支出上限；其限制由客戶團隊另行安排。 ### 達到支出上限 一旦達到您所屬層級的支出上限，API 使用將暫停至下個月第一天的 00:00 UTC，除非您提前申請更高的限制。使用暫停期間，API 請求會回傳 HTTP 429： ```json { "type": "error", "error": { "type": "rate_limit_error", "message": "You have reached your API usage limits: your organization has crossed its monthly API usage threshold, set based on your organization's API tier. You will regain access on 2026-09-01 at 00:00 UTC.", "details": { "error_code": "enforced_spend_limit_reached" } }, "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG" } ``` * 錯誤類型為 `rate_limit_error`，與速率限制相同，但回應中沒有 `retry-after` 標頭。在恢復存取之前，重試（包括 SDK 的自動重試）都會失敗。 * 在 Messages API 上，`error.details.error_code` 為 `enforced_spend_limit_reached`。您可以用它來區分此回應與速率限制。 * 升級至更高層級即可恢復存取；請參閱[申請更高的限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#requesting-higher-limits)。 ### 設定您自己的支出限制 您也可以設定低於所屬層級上限的自訂支出限制以控制成本： 在 Claude Console 中，前往[帳單](https://platform.claude.com/settings/billing)頁面（`platform.claude.com/settings/billing`）。 在**支出限額**區段中，點擊**調整限制**（若目前尚未設定限制，則點擊**設定限制**）。 輸入新的數值。您的支出限制不得超過目前層級的上限。 當使用量達到您設定的支出限制時，請求會傳回 HTTP 400，錯誤類型為 `invalid_request_error`。訊息開頭為 `You have reached your specified API usage limits`，若為工作區限制則為 `You have reached your specified workspace API usage limits`，並說明存取何時恢復。提高或移除限制即可提前恢復存取。 [Claude Code 工作區](https://platform.claude.com/docs/zh-TW/manage-claude/workspaces#claude-code-workspace)的限制會另行檢查：超出該工作區限制的 Claude Code 請求可能會改為收到帶有 `retry-after` 標頭的 429。 ## 速率限制 Messages API 的速率限制針對每個模型類別，以每分鐘請求數（RPM）、每分鐘輸入 token 數（ITPM）和每分鐘輸出 token 數（OTPM）來衡量。 如果您超過任何速率限制，您會收到說明哪個速率限制被超過的 [429 錯誤](https://platform.claude.com/docs/zh-TW/api/errors)。當回應帶有 `retry-after` 標頭時，請等待該秒數後再重試。 如果您的組織使用量急劇增加，您也可能因為 API 的加速限制（acceleration limits）而遇到 429 錯誤。為避免觸及加速限制，請逐步增加流量並維持一致的使用模式。 ### 快取感知的 ITPM 許多 API 供應商使用合併的「每分鐘 token 數」（TPM）限制，其中可能包括所有 token，無論是快取或未快取的、輸入或輸出的。**Claude 的預設 ITPM 速率限制只計入未快取的輸入 token。** 這是一項關鍵優勢，使速率限制實際上比初看之下更高。 ITPM 速率限制會在每個請求開始時進行估算，並在請求過程中調整估算值，以反映實際使用的輸入權杖數量。 以下是計入 ITPM 的項目： * `input_tokens`（最後一個快取斷點之後的權杖）✓ **計入 ITPM** * `cache_creation_input_tokens`（正在寫入快取的權杖）✓ **計入 ITPM** * `cache_read_input_tokens`（從快取讀取的權杖）✗ **不計入 ITPM** `input_tokens` 欄位僅代表出現在 **您最後一個快取斷點之後** 的權杖，而非請求中的所有輸入權杖。若要計算總輸入權杖數： ```text wrap total_input_tokens = cache_read_input_tokens + cache_creation_input_tokens + input_tokens ``` 這表示當您有快取內容時，`input_tokens` 通常會遠小於您的總輸入量。例如，若有一份 200k token 的快取文件和一個 50 token 的使用者問題，即使總輸入為 200,050 個 token，您看到的也會是 `input_tokens: 50`。 就速率限制而言，只有 `input_tokens` + `cache_creation_input_tokens` 會計入您的 ITPM 限制，這使得[「prompt caching」（提示快取）](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching)成為提高吞吐量的有效方法。 **範例：** 在 2,000,000 ITPM 限制和 80% 快取命中率的情況下，由於快取 token 不計入速率限制，您實際上每分鐘可處理 10,000,000 個總輸入 token（2M 未快取 + 8M 快取）。這些快取 token 以[快取讀取費率](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching#pricing)計費，僅為基本輸入價格的一小部分。 為了在速率限制內獲得最高吞吐量，請快取重複的內容，例如系統指示和提示、大型上下文文件、工具定義以及對話歷史；相關指引請參閱[提示快取](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching)。透過有效的快取，您可以在不提高速率限制的情況下大幅提升實際吞吐量。您可以在 Claude Console 的[使用量](https://platform.claude.com/usage)頁面監控快取命中率，以調整您的快取策略。 OTPM 速率限制會在產生輸出權杖時即時評估，僅計算實際產生的權杖。`max_tokens` 參數不會納入 OTPM 速率限制的計算，因此設定較高的 `max_tokens` 值不會對速率限制造成不利影響。 下列表格中的每一列都有各自的 RPM、ITPM 和 OTPM 限制。部分列涵蓋多個共用同一限制的模型；請參閱表格下方的附註。 您可以在 Claude Console 的[速率限制](https://platform.claude.com/usage/limits)頁面查看您目前的「rate limit」（速率限制）與行為，或使用[速率限制 API](https://platform.claude.com/docs/zh-TW/manage-claude/rate-limits-api) 以程式化方式讀取已設定的限制並設定工作區限制。 速率限制在所有 `inference_geo` 值之間共用。使用 `inference_geo: "us"` 和 `inference_geo: "global"` 的請求會從同一個速率限制池中扣除。 | 模型 | 每分鐘最大請求數（RPM） | 每分鐘最大輸入 token 數（ITPM） | 每分鐘最大輸出 token 數（OTPM） | | --------------------------------------------- | ------------- | --------------------- | --------------------- | | Claude Fable 5.2 | 4,000 | 500,000 | 100,000 | | Claude Fable 5.1 和 Claude Fable 51 | 4,000 | 500,000 | 100,000 | | Claude Opus 5.5 | 4,000 | 2,000,000 | 400,000 | | Claude Opus 5 | 1,000 | 2,000,000 | 400,000 | | Claude Opus 4.x2 | 1,000 | 2,000,000 | 400,000 | | Claude Sonnet 5.5 | 4,000 | 2,000,000 | 400,000 | | Claude Sonnet 5 | 1,000 | 2,000,000 | 400,000 | | Claude Sonnet 4.x3 | 1,000 | 2,000,000 | 400,000 | | Claude Haiku 5.5 | 4,000 | 2,000,000 | 400,000 | | Claude Haiku 4.5 | 1,000 | 2,000,000 | 400,000 | | 模型 | 每分鐘最大請求數（RPM） | 每分鐘最大輸入 token 數（ITPM） | 每分鐘最大輸出 token 數（OTPM） | | --------------------------------------------- | ------------- | --------------------- | --------------------- | | Claude Fable 5.2 | 10,000 | 1,500,000 | 300,000 | | Claude Fable 5.1 和 Claude Fable 51 | 10,000 | 1,500,000 | 300,000 | | Claude Opus 5.5 | 10,000 | 5,000,000 | 1,000,000 | | Claude Opus 5 | 5,000 | 5,000,000 | 1,000,000 | | Claude Opus 4.x2 | 5,000 | 5,000,000 | 1,000,000 | | Claude Sonnet 5.5 | 10,000 | 5,000,000 | 1,000,000 | | Claude Sonnet 5 | 5,000 | 5,000,000 | 1,000,000 | | Claude Sonnet 4.x3 | 5,000 | 5,000,000 | 1,000,000 | | Claude Haiku 5.5 | 10,000 | 5,000,000 | 1,000,000 | | Claude Haiku 4.5 | 5,000 | 5,000,000 | 1,000,000 | | 模型 | 每分鐘最大請求數（RPM） | 每分鐘最大輸入 token 數（ITPM） | 每分鐘最大輸出 token 數（OTPM） | | --------------------------------------------- | ------------- | --------------------- | --------------------- | | Claude Fable 5.2 | 13,000 | 4,000,000 | 800,000 | | Claude Fable 5.1 和 Claude Fable 51 | 13,000 | 4,000,000 | 800,000 | | Claude Opus 5.5 | 13,000 | 10,000,000 | 2,000,000 | | Claude Opus 5 | 10,000 | 10,000,000 | 2,000,000 | | Claude Opus 4.x2 | 10,000 | 10,000,000 | 2,000,000 | | Claude Sonnet 5.5 | 13,000 | 10,000,000 | 2,000,000 | | Claude Sonnet 5 | 10,000 | 10,000,000 | 2,000,000 | | Claude Sonnet 4.x3 | 10,000 | 10,000,000 | 2,000,000 | | Claude Haiku 5.5 | 13,000 | 10,000,000 | 2,000,000 | | Claude Haiku 4.5 | 10,000 | 10,000,000 | 2,000,000 | 如果您需要高於 Scale 層級的限制，請透過 Claude Console 中的[速率限制](https://platform.claude.com/usage/limits)頁面聯繫銷售團隊。 *1 Fable 速率限制為總限制，適用於 Claude Fable 5.1 和 Claude Fable 5 的合併流量。Claude Fable 5.2 擁有獨立的速率限制，不屬於此合併額度。Claude Mythos 5.2、Claude Mythos 5.1 和 Claude Mythos 5 共用另一個獨立的合併限制。* *2 Opus 速率限制為總限制，適用於 Claude Opus 4.8、Opus 4.7、Opus 4.6 和 Opus 4.5 的合併流量。Claude Opus 5.5 和 Claude Opus 5 各自擁有獨立的速率限制，不屬於此合併額度。* *3 Sonnet 4.x 速率限制為總限制，適用於 Sonnet 4.6 和 Sonnet 4.5（已棄用；請參閱[模型棄用](https://platform.claude.com/docs/zh-TW/about-claude/model-deprecations)）的合併流量。Claude Sonnet 5.5 和 Claude Sonnet 5 各自擁有獨立的速率限制，不屬於此合併額度。* ### Message Batches API Message Batches API 有自己的一組速率限制，在所有模型之間共用。這些限制包括適用於所有 API 端點的每分鐘請求數（RPM）限制，以及可同時處於處理佇列中的批次請求數量限制。此處的「批次請求」是指 Message Batch 的一部分。您可以建立包含數千個批次請求的 Message Batch，每個批次請求都會計入此限制。批次請求會一直留在處理佇列中，直到模型成功處理為止。 | 每分鐘最大請求數（RPM） | 處理佇列中的最大批次請求數 | 每個批次的最大批次請求數 | | ------------- | ------------- | ------------ | | 1,000 | 200,000 | 100,000 | | 每分鐘最大請求數（RPM） | 處理佇列中的最大批次請求數 | 每個批次的最大批次請求數 | | ------------- | ------------- | ------------ | | 2,000 | 300,000 | 100,000 | | 每分鐘最大請求數（RPM） | 處理佇列中的最大批次請求數 | 每個批次的最大批次請求數 | | ------------- | ------------- | ------------ | | 4,000 | 500,000 | 100,000 | 如果您需要高於 Scale 層級的限制，請透過 Claude Console 中的[速率限制](https://platform.claude.com/usage/limits)頁面聯繫銷售團隊。 ### Managed Agents [Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview) 端點會針對每個組織進行速率限制。這些限制與本頁面前面所述的 Messages API 速率限制是分開的。 | 操作 | 限制 | | ------------------------------- | ------------- | | 建立端點（例如代理、工作階段與環境） | 每分鐘 300 次請求 | | 讀取端點（例如 retrieve、list 與 stream） | 每分鐘 1,200 次請求 | ### Files API [Files API](https://platform.claude.com/docs/zh-TW/build-with-claude/files) 請求有其自己的每組織限制，在上傳、列出、擷取、下載與刪除操作之間共用，並與本頁前述的 Messages API 限制分開計算。目前的數值請參閱 [Files API 速率限制](https://platform.claude.com/docs/zh-TW/build-with-claude/files#rate-limits)。 ### 快速模式速率限制 在 Claude Fable 5.2、Claude Mythos 5.2、Claude Opus 5.5、Claude Opus 5，或 Claude Opus 4.8 上以 `speed: "fast"` 使用 [fast mode](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode)（快速模式）時，會套用專屬的速率限制。這些限制與標準速率限制分開計算。Claude Opus 5.5 在 Start、Build 和 Scale 層級都有預設的快速模式速率限制，因此您無需申請存取權，即可搭配此模型使用快速模式。評估層級的組織在升級至 Start、Build 或 Scale 層級後，即可搭配 Claude Opus 5.5 使用快速模式。Claude Fable 5.2 亦同。這也適用於 Claude Mythos 5.2。Claude Opus 5 和 Claude Opus 4.8 的快速模式目前處於研究預覽階段。若要查看您的快速模式速率限制，請前往 Claude Console 的[速率限制](https://platform.claude.com/usage/limits)頁面。超過快速模式速率限制時，API 會回傳帶有 `retry-after` 標頭的 `429` 錯誤。 回應中包含 `anthropic-fast-*` 標頭，用以指示您的快速模式速率限制狀態。有關這些標頭的詳情，請參閱[快速模式速率限制](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#rate-limits)。 ### 在 Console 中監控您的速率限制 您可以在 [Claude Console](https://platform.claude.com/) 的[使用量](https://platform.claude.com/usage)頁面監控您的速率限制使用情況。 除了提供 token 和請求圖表外，**使用量**頁面還提供兩個獨立的速率限制圖表。您可以使用這些圖表查看還有多少成長空間、找出何時可能達到使用高峰、了解應申請哪些速率限制，以及學習如何提高快取率。這些圖表會將特定速率限制（例如每個模型）的多項指標視覺化： * **Rate Limit - Input Tokens**（速率限制 - 輸入權杖）圖表包含： * 每小時的每分鐘未快取輸入權杖數最大值 * 您目前的每分鐘輸入權杖數速率限制 * 您輸入權杖的快取率（即從快取讀取的輸入權杖百分比） * **Rate Limit - Output Tokens**（速率限制 - 輸出權杖）圖表包含： * 每小時的每分鐘輸出權杖數最大值 * 您目前的每分鐘輸出權杖數速率限制 ## 申請更高的限制 若要申請更高的速率限制或更高的每月支出上限，請使用 Claude Console 中[速率限制](https://platform.claude.com/usage/limits)頁面上的**申請提高層級**。Anthropic 支援團隊也可以提高限制；如有緊急需求，請聯繫 [Anthropic 支援](https://support.claude.com)。 **[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws)：** **申請提高層級**流程無法使用。請聯繫您的 Anthropic 客戶代表或 [Anthropic 支援](https://support.claude.com)，並提供您需要提高限制的模型、每個模型的每分鐘輸入與輸出權杖峰值，以及您的輸入中大約有多少比例是已快取或重複的上下文。請參閱 [Claude Platform on AWS 的速率限制與配額](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)。 ## 為工作區設定較低的限制 有關工作區的更多資訊，請參閱[工作區](https://platform.claude.com/docs/zh-TW/manage-claude/workspaces)。 為了保護您組織中的工作區免於潛在的過度使用，您可以為每個工作區設定自訂的支出和速率限制。 範例：若您組織的限制為每分鐘 40,000 個輸入權杖與每分鐘 8,000 個輸出權杖，您可以將某個工作區限制為每分鐘 30,000 個輸入權杖。這可保護其他工作區免於潛在的過度使用，並讓資源在您的組織中更平均地分配。其餘每分鐘 10,000 個輸入權杖，加上該工作區未用到的 30,000 個中的任何部分，仍可供其他工作區使用。 注意： * 您無法為預設工作區設定支出限制。 * 若未設定，工作區限制會與組織的限制相同。 * 工作區限制是針對每種限制器類型設定的（例如每分鐘請求數、每分鐘輸入 token 數或每分鐘輸出 token 數）。 * 組織層級的限制始終適用，即使各工作區限制加總後超過該值亦然。 若要以程式化方式讀取您目前的組織與工作區速率限制，或設定工作區速率限制，請使用[速率限制 API](https://platform.claude.com/docs/zh-TW/manage-claude/rate-limits-api)。 ## 回應標頭 API 回應包含標頭，顯示所強制執行的速率限制、目前使用量，以及限制何時重設。 會回傳以下標頭： | 標頭 | 說明 | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `retry-after` | 在您可以重試請求之前需等待的秒數。提前重試將會失敗。並非每個 429 都帶有此標頭；支出上限的 429 則一律不帶（請參閱[達到支出上限](https://platform.claude.com/docs/zh-TW/api/rate-limits#reaching-your-spend-cap)）。 | | `anthropic-ratelimit-requests-limit` | 任何速率限制期間內允許的最大請求數。 | | `anthropic-ratelimit-requests-remaining` | 在受到速率限制之前剩餘的請求數。 | | `anthropic-ratelimit-requests-reset` | 請求速率限制完全補充的時間，以 RFC 3339 格式提供。 | | `anthropic-ratelimit-tokens-limit` | 任何速率限制期間內允許的最大權杖數。 | | `anthropic-ratelimit-tokens-remaining` | 在受到速率限制之前剩餘的權杖數（四捨五入至最接近的千位）。 | | `anthropic-ratelimit-tokens-reset` | 權杖速率限制完全補充的時間，以 RFC 3339 格式提供。 | | `anthropic-ratelimit-input-tokens-limit` | 任何速率限制期間內允許的最大輸入權杖數。 | | `anthropic-ratelimit-input-tokens-remaining` | 在受到速率限制之前剩餘的輸入權杖數（四捨五入至最接近的千位）。 | | `anthropic-ratelimit-input-tokens-reset` | 輸入權杖速率限制完全補充的時間，以 RFC 3339 格式提供。 | | `anthropic-ratelimit-output-tokens-limit` | 任何速率限制期間內允許的最大輸出權杖數。 | | `anthropic-ratelimit-output-tokens-remaining` | 在受到速率限制之前剩餘的輸出權杖數（四捨五入至最接近的千位）。 | | `anthropic-ratelimit-output-tokens-reset` | 輸出權杖速率限制完全補充的時間，以 RFC 3339 格式提供。 | | `anthropic-priority-input-tokens-limit` | 任何速率限制期間內允許的最大 Priority Tier 輸入權杖數。（僅限 Priority Tier） | | `anthropic-priority-input-tokens-remaining` | 在受到速率限制之前剩餘的 Priority Tier 輸入權杖數（四捨五入至最接近的千位）。（僅限 Priority Tier） | | `anthropic-priority-input-tokens-reset` | Priority Tier 輸入權杖速率限制完全補充的時間，以 RFC 3339 格式提供。（僅限 Priority Tier） | | `anthropic-priority-output-tokens-limit` | 任何速率限制期間內允許的最大 Priority Tier 輸出權杖數。（僅限 Priority Tier） | | `anthropic-priority-output-tokens-remaining` | 在受到速率限制之前剩餘的 Priority Tier 輸出權杖數（四捨五入至最接近的千位）。（僅限 Priority Tier） | | `anthropic-priority-output-tokens-reset` | Priority Tier 輸出權杖速率限制完全補充的時間，以 RFC 3339 格式提供。（僅限 Priority Tier） | `anthropic-ratelimit-tokens-*` 標頭顯示目前生效的最嚴格限制的數值。例如，若您已超出工作區的每分鐘權杖限制，標頭將包含工作區每分鐘權杖速率限制的數值。若工作區限制不適用，標頭將回傳剩餘的總權杖數，其中總數為輸入與輸出權杖的總和。若要查看某個請求計入了哪個工作區，請讀取 `anthropic-workspace-id` [回應標頭](https://platform.claude.com/docs/zh-TW/api/overview#response-headers)，其中包含您的 API 金鑰或存取權杖所解析到的工作區 ID。