快速模式
從支援的 Claude 模型獲得最高 2.5 倍的每秒輸出 token 數。
用法因產品而異
speed: "fast"。speed,例如 {"id": "claude-opus-5-5", "speed": "fast"}。「Fast mode」(快速模式)以進階定價提供最高 2.5 倍的每秒輸出 token 數。在您的請求中設定 speed: "fast" 即可選擇加入。快速模式可在 Claude Fable 5.2、Claude Mythos 5.2 和 Claude Opus 5.5 上使用。快速模式在 Claude Opus 5 上處於研究預覽階段,在 Claude Opus 4.8 上已被棄用。
快速模式的運作方式
快速模式以更快的推論配置執行相同的模型。智慧或能力不會有任何變化。
- 與標準速度相比,每秒輸出 token 數最高可提升 2.5 倍
- 速度優勢集中在「output tokens per second」(每秒輸出 token 數),即 OTPS,而非「time to first token」(首個 token 產生時間),即 TTFT
- 相容於 串流,在串流中 OTPS 的提升最為明顯
基本用法
快速模式僅適用於支援的模型。詳情請參閱可用性,包括哪些模型需要 beta 標頭。
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=4096,
speed="fast",
messages=[
{"role": "user", "content": "Refactor this module to use dependency injection"}
],
)
for block in response.content:
if block.type == "text":
print(block.text)在 Microsoft Foundry 中的 Claude 上,快速模式有自己的模型 ID,且速度由部署決定。請將快速模式請求傳送到快速模式模型的部署,並省略 speed:
| 模型 | 快速模式模型 ID |
|---|---|
| Claude Fable 5.2 | claude-fable-5-2-fast |
| Claude Mythos 5.2 | claude-mythos-5-2-fast |
| Claude Opus 5.5 | claude-opus-5-5-fast |
在標準模型(例如 claude-opus-5-5)的部署上設定 speed 的請求會傳回錯誤。
速率限制
快速模式有專屬的「rate limit」(速率限制),與標準速率限制分開。當您超過快速模式的速率限制時,API 會傳回 429 錯誤,並附帶 retry-after 標頭,指出何時會有可用容量。在 Claude Models on Google Cloud (Google managed) 上,速率限制和配額由 Google Cloud 管理。
Claude Fable 5.2、Claude Mythos 5.2 和 Claude Opus 5.5 具有預設的快速模式速率限制。預設限制適用於 Start、Build 和 Scale 用量層級。您無需為這些模型申請快速模式存取權。處於評估層級的組織在升級到 Start、Build 或 Scale 層級後,即可在這些模型上使用快速模式。
回應中包含指示您快速模式速率限制狀態的標頭:
| 標頭 | 說明 |
|---|---|
anthropic-fast-input-tokens-limit | 每分鐘快速模式輸入 token 數上限 |
anthropic-fast-input-tokens-remaining | 剩餘的快速模式輸入 token 數 |
anthropic-fast-input-tokens-reset | 快速模式輸入 token 限制重設的時間 |
anthropic-fast-output-tokens-limit | 每分鐘快速模式輸出 token 數上限 |
anthropic-fast-output-tokens-remaining | 剩餘的快速模式輸出 token 數 |
anthropic-fast-output-tokens-reset | 快速模式輸出 token 限制重設的時間 |
若要查看您的快速模式速率限制,請前往 Claude Console 中的速率限制頁面。
檢查使用了哪種速度
回應的 usage 物件包含一個 speed 欄位,指出使用了哪種速度,即 "fast" 或 "standard"。在不支援快速模式的模型上請求 speed: "fast" 會傳回錯誤,超過快速模式的速率限制或容量時也會傳回錯誤(429 或 529)。當帶有 speed: "fast" 的請求成功時,usage.speed 為 "fast"。Claude Opus 4.6 是例外:帶有 speed: "fast" 和 fast-mode-2026-02-01 beta 標頭的請求不會傳回錯誤,而是會成功,但以標準速度執行。在這種情況下,usage.speed 會顯示 "standard"。在 Claude Models on Google Cloud (Anthropic managed) 上,帶有 speed: "fast" 的 Claude Opus 4.6 請求即使附帶標頭也會傳回 400 錯誤。
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
speed="fast",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.usage.speed) # "fast" or "standard"{
"id": "msg_01XFDUDYJgAACzvnptvVoYEL",
"type": "message",
"role": "assistant",
"usage": {
"input_tokens": 8,
"output_tokens": 12,
"speed": "fast"
}
}若要追蹤整個組織的快速模式使用量與成本,請參閱用量與成本分析 API。
重試與備援
自動重試
SDK 預設會自動重試快速模式的 429 錯誤最多 2 次(可透過 max_retries 設定),並在每次重試前等待 retry-after 標頭中的延遲時間。由於快速模式採用持續的 token 補充機制,retry-after 延遲通常很短,一旦有可用容量,請求就會成功。
退回標準速度
如果您希望退回標準速度而不是等待快速模式容量,請捕捉速率限制錯誤,並在不帶 speed: "fast" 的情況下重試。在 Microsoft Foundry 中的 Claude 上,速度由部署決定,因此請改為在標準模型的部署上重試。在初始的快速請求中將 max_retries 設為 0,以略過自動重試,並在遇到速率限制錯誤時立即失敗。
由於將 max_retries 設為 0 也會停用其他暫時性錯誤(過載、內部伺服器錯誤)的重試,以下範例會在發生這些錯誤後重新傳送請求。
client = anthropic.Anthropic()
def create_message_with_fast_fallback(max_retries=0, max_attempts=3, **params):
try:
return client.with_options(max_retries=max_retries).messages.create(**params)
except anthropic.RateLimitError:
if params.get("speed") == "fast":
del params["speed"]
return create_message_with_fast_fallback(max_retries=max_retries, **params)
raise
except (
anthropic.APIStatusError,
anthropic.APIConnectionError,
) as error:
if isinstance(error, anthropic.APIStatusError) and error.status_code < 500:
raise
if max_attempts > 1:
return create_message_with_fast_fallback(
max_retries=max_retries, max_attempts=max_attempts - 1, **params
)
raise
message = create_message_with_fast_fallback(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
speed="fast",
max_retries=0,
)注意事項
- Batch API: 快速模式無法與 Batch API 一起使用。
- Priority Tier: 快速模式無法與 Priority Tier 承諾一起使用。
定價
快速模式的定價是在整個「context window」(上下文視窗)範圍內以標準費率乘上倍數計算,包括超過 200k 輸入 token 的請求。在 Claude Models on Google Cloud (Google managed) 上,快速模式的價格由 Google Cloud 設定。請參閱雲端平台定價。
| 模型 | 輸入 | 輸出 |
|---|---|---|
| Claude Fable 5.2 | $16 USD / MTok | $80 USD / MTok |
| Claude Mythos 5.2 | $16 USD / MTok | $80 USD / MTok |
| Claude Opus 5.5 | $8 USD / MTok | $40 USD / MTok |
| Claude Opus 5 / Claude Opus 4.8 | $10 USD / MTok | $50 USD / MTok |
快速模式定價會與其他定價修正因子疊加:
如需完整的定價詳情,請參閱定價頁面。
可用性
快速模式僅適用於以下模型。如果您先前在較早的模型上使用快速模式,請遷移到支援快速模式的模型。
若要在 Claude Opus 5 上使用快速模式,請聯繫您的客戶經理或加入候補名單。
Claude API
- API
- Messages API
- Managed Agents僅適用於 Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8
- 模型
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Opus 5.5
- Claude Opus 5 研究預覽, 需要
- Claude Opus 4.8 已棄用, 需要
移除日期:2026 年 11 月 30 日。移除後,對
claude-opus-4-8發出且搭配speed: "fast"的請求將會傳回錯誤。若要繼續使用快速模式,請遷移至 Claude Opus 5.5。請參閱從 Claude Opus 4.8 遷移至 Claude Opus 5.5。
Claude Models on Google Cloud (Anthropic managed)
- API
- Messages API
- Managed Agents僅適用於 Claude Opus 5.5
- 模型
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Opus 5.5
Claude Models on Google Cloud (Google managed)
- API
- Messages API
- 模型
- Claude Fable 5.2
- Claude Mythos 5.2
Microsoft Foundry (hosted on Azure)
- API
- Messages API
- 模型
- Claude Opus 5.5
- 注意
在 Microsoft Foundry 上,快速模式有自己的模型 ID,以
-fast結尾。請將請求傳送至快速模式模型的部署,並省略speed。
Microsoft Foundry (hosted on Anthropic)
- API
- Messages API
- 模型
- Claude Fable 5.2
- Claude Mythos 5.2
- 注意
在 Microsoft Foundry 上,快速模式有自己的模型 ID,以
-fast結尾。請將請求傳送至快速模式模型的部署,並省略speed。
資料處理
資料處理概覽適用端點
/v1/messages搭配speed: "fast"
後續步驟
這個頁面有幫助嗎?