Fast mode
Get up to 2.5x higher output tokens per second from supported Claude models.
Usage differs by product
speed: "fast" on the request.speed on the agent’s model object, for example {"id": "claude-opus-5-5", "speed": "fast"}.Fast mode delivers up to 2.5x higher output tokens per second at premium pricing. Set speed: "fast" on your request to opt in. Fast mode is available on Claude Fable 5.2, Claude Mythos 5.2, and Claude Opus 5.5. Fast mode is in research preview on Claude Opus 5 and deprecated on Claude Opus 4.8.
How fast mode works
Fast mode runs the same model with a faster inference configuration. There is no change to intelligence or capabilities.
- Up to 2.5x higher output tokens per second compared to standard speed
- Speed benefits are focused on output tokens per second (OTPS), not time to first token (TTFT)
- Compatible with streaming, where the OTPS gain is most visible
Basic usage
Fast mode works only on supported models. See Availability for details, including which models need a beta header.
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)On Claude in Microsoft Foundry, fast mode has its own model IDs, and the deployment sets the speed. Send fast mode requests to a deployment of the fast mode model, and leave out speed:
| Model | Fast mode model 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 |
A request that sets speed on a deployment of the standard model, such as claude-opus-5-5, returns an error.
Rate limits
Fast mode has a dedicated rate limit that is separate from standard rate limits. When you exceed your fast mode rate limit, the API returns a 429 error with a retry-after header that says when capacity is available. On Claude Models on Google Cloud (Google managed), Google Cloud manages rate limits and quotas.
Claude Fable 5.2, Claude Mythos 5.2, and Claude Opus 5.5 have a default fast mode rate limit. The default limit applies in the Start, Build, and Scale usage tiers. You don’t need to request fast mode access for these models. Organizations in the Evaluation tier can use fast mode with these models once they move to the Start, Build, or Scale tier.
The response includes headers that indicate your fast mode rate limit status:
| Header | Description |
|---|---|
anthropic-fast-input-tokens-limit | Maximum fast mode input tokens per minute |
anthropic-fast-input-tokens-remaining | Remaining fast mode input tokens |
anthropic-fast-input-tokens-reset | Time when the fast mode input token limit resets |
anthropic-fast-output-tokens-limit | Maximum fast mode output tokens per minute |
anthropic-fast-output-tokens-remaining | Remaining fast mode output tokens |
anthropic-fast-output-tokens-reset | Time when the fast mode output token limit resets |
To see your fast mode rate limits, go to the Rate limits page in the Claude Console.
Checking which speed was used
The response usage object includes a speed field that indicates which speed was used, either "fast" or "standard". Requesting speed: "fast" on a model that doesn’t support fast mode returns an error, and so does exceeding fast mode’s rate limits or capacity (a 429 or 529). When a request with speed: "fast" succeeds, usage.speed is "fast". Claude Opus 4.6 is an exception: instead of returning an error, a request with speed: "fast" and the fast-mode-2026-02-01 beta header succeeds, but runs at standard speed. In this situation, usage.speed shows "standard". On Claude Models on Google Cloud (Anthropic managed), a Claude Opus 4.6 request with speed: "fast" returns a 400 error even with the header.
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"
}
}To track fast mode usage and costs across your organization, see the Usage and Cost Analytics API.
Retries and fallbacks
Automatic retries
The SDK automatically retries fast mode 429 errors up to two times by default (configurable with max_retries), waiting for the delay in the retry-after header before each retry. Because fast mode uses continuous token replenishment, the retry-after delay is typically short and requests succeed once capacity is available.
Falling back to standard speed
If you’d prefer to fall back to standard speed rather than wait for fast mode capacity, catch the rate limit error and retry without speed: "fast". On Claude in Microsoft Foundry, the deployment sets the speed, so retry on a deployment of the standard model instead. Set max_retries to 0 on the initial fast request to skip automatic retries and fail immediately on rate limit errors.
Because setting max_retries to 0 also disables retries for other transient errors (overloaded, internal server errors), the following examples resend the request after those errors.
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,
)Considerations
- Batch API: Fast mode is not available with the Batch API.
- Priority Tier: Fast mode is not available with a Priority Tier commitment.
Pricing
Fast mode is priced at a multiplier on standard rates across the full context window, including requests over 200k input tokens. On Claude Models on Google Cloud (Google managed), Google Cloud sets fast mode prices. See Cloud platform pricing.
| Model | Input | Output |
|---|---|---|
| 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 |
Fast mode pricing stacks with other pricing modifiers:
- Prompt caching multipliers apply on top of fast mode pricing.
- Data residency multipliers apply on top of fast mode pricing.
For complete pricing details, see the Pricing page.
Availability
Fast mode is available only on the following models. If you were using fast mode on an earlier model, migrate to a model that supports fast mode.
To access fast mode on Claude Opus 5, contact your account manager or join the waitlist.
Claude API
- APIs
- Messages API
- Managed AgentsOnly with Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8
- Models
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Opus 5.5
- Claude Opus 5 Research preview, requires
- Claude Opus 4.8 Deprecated, requires
Removal date: November 30, 2026. After removal, requests to
claude-opus-4-8withspeed: "fast"will return an error. To continue using fast mode, migrate to Claude Opus 5.5. See Migrating to Claude Opus 5.5 from Claude Opus 4.8.
Claude Models on Google Cloud (Anthropic managed)
- APIs
- Messages API
- Managed AgentsOnly with Claude Opus 5.5
- Models
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Opus 5.5
Claude Models on Google Cloud (Google managed)
- API
- Messages API
- Models
- Claude Fable 5.2
- Claude Mythos 5.2
Microsoft Foundry (hosted on Azure)
- API
- Messages API
- Model
- Claude Opus 5.5
- Note
On Microsoft Foundry, fast mode has its own model IDs, which end in
-fast. Send requests to a deployment of the fast mode model, and leave outspeed.
Microsoft Foundry (hosted on Anthropic)
- API
- Messages API
- Models
- Claude Fable 5.2
- Claude Mythos 5.2
- Note
On Microsoft Foundry, fast mode has its own model IDs, which end in
-fast. Send requests to a deployment of the fast mode model, and leave outspeed.
Data handling
Data handling overviewApplicable endpoints
/v1/messageswithspeed: "fast"
Excludes Covered Models
Same Messages API endpoint with faster inference. ZDR applies regardless of speed setting.
Next steps
Get validated JSON results from agent workflows.
Learn about Anthropic’s pricing structure for models and features.
Control how many tokens Claude uses when responding with the effort parameter, trading off between response thoroughness and token efficiency.
Stream Messages API responses incrementally with server-sent events, including text, tool use, and extended thinking deltas.
Was this page helpful?