# Models
All documentation for Models.
---
## about-claude-models-choosing-a-model-38ebff0fff.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Fchoosing-a-model)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5](/docs/en/models/sonnet-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
[Models & pricing](/docs/en/models/overview)Guides
# Choosing the right model
Copy page
Choosing a Claude model means balancing capabilities, speed, and cost. This guide covers the questions to ask, two ways to pick a starting model, and how to test the choice.
Copy page
## Establish key criteria
When choosing a Claude model, consider first evaluating these factors:
- **Capabilities:** What specific features or capabilities will you need the model to have to meet your needs?
- **Speed:** How quickly does the model need to respond in your application? Claude Opus 5.5, Claude Opus 5, and Claude Opus 4.8 support [fast mode](/docs/en/build-with-claude/fast-mode) (research preview), which delivers up to 2.5x higher output speed at premium pricing.
- **Cost:** What's your budget for both development and production usage?
- **Effort:** Several Claude models support an [effort parameter](/docs/en/build-with-claude/effort) that trades intelligence for latency and cost within a single model. Tuning effort is often a better lever than switching models. On Claude Fable 5.1 and Claude Opus 5, start with the default (`high`) and adjust up or down based on your evals. On Claude Opus 5.5 the default is `medium`; start there and adjust the same way. On Claude Opus 4.8 and Claude Opus 4.7, the `xhigh` effort level, between `high` and `max`, is the best setting for most coding and agentic use cases.
------------------------------------------------------------------------
## Choose the best model to start with
There are two general approaches you can use to start testing which Claude model best works for your needs.
### Option 1: Start efficiency-first
For many applications, starting with a faster, more cost-effective model like Claude Haiku 4.5 can be the optimal approach:
1. Begin implementation with Claude Haiku 4.5.
2. Test your use case thoroughly.
3. Evaluate if performance meets your requirements.
4. Upgrade only if necessary for specific capability gaps.
This approach allows for quick iteration, lower development costs, and is often sufficient for many common applications. This approach is best for:
- Initial prototyping and development
- Applications with tight latency requirements
- Cost-sensitive implementations
- High-volume, straightforward tasks
### Option 2: Start capability-first
For complex tasks where intelligence and advanced capabilities are paramount, you may want to start capability-first: implement with the strongest starting point for your task, then optimize to more efficient models down the line:
1. Implement with Claude Opus 5.5.
2. [Optimize your prompts](/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5) for this model.
3. Evaluate if performance meets your requirements.
4. Consider increasing efficiency by lowering [effort](/docs/en/build-with-claude/effort) or downgrading models over time with greater workflow optimization.
5. If your evals at `xhigh` or `max` effort still fall short on demanding reasoning or long-horizon agentic work, move to [Claude Fable 5.1](/docs/en/models/fable-5-1/whats-new-fable-5-1).
This approach is best for:
- Complex reasoning tasks
- Scientific or mathematical applications
- Tasks requiring nuanced understanding
- Applications where accuracy outweighs cost considerations
- Advanced coding and high-autonomy agentic work
**Claude Opus 5.5** (`claude-opus-5-5`) is built for long-running agentic coding and knowledge work, with [adaptive thinking](/docs/en/build-with-claude/thinking) always on. If your integration forces tool use (`tool_choice` of type `any` or `tool`), turns thinking off, or uses the `computer_20251124` computer use tool, see [Breaking changes](/docs/en/models/opus-5-5/whats-new-opus-5-5#breaking-changes) before switching.
**Claude Fable 5.1** (`claude-fable-5-1`) is Anthropic's most capable model open to all customers. It extends Claude Fable 5 with stronger long-running agentic coding, knowledge work, and research at the same input and output prices, with cache reads at a quarter of the cost. **Claude Mythos 5.1** (`claude-mythos-5-1`) offers the same capabilities to [Project Glasswing](https://anthropic.com/glasswing) participants only. Both models use always-on [adaptive thinking](/docs/en/build-with-claude/thinking). See [What's new in Claude Fable 5.1](/docs/en/models/fable-5-1/whats-new-fable-5-1) for details.
For context windows, output limits, and prices, see the [model comparison table](/docs/en/models/overview#latest-models-comparison).
## Model selection matrix
Most workloads start with Claude Opus 5.5.
| When you need... | Consider starting with... | Example use cases |
|---------------------------------------------------------------------------|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
| The highest available capability | Claude Fable 5.1 | Agent sessions that run for hours, multistep deep research, analysis carried through to a finished document, spreadsheet, or deck |
| Complex agentic coding and enterprise work | Claude Opus 5.5 | Multihour autonomous coding agents, large-scale refactoring, complex systems engineering, vision-heavy workflows, computer use |
| Speed and capability for everyday coding, agent, and enterprise workloads | Claude Sonnet 5 | Code generation, data analysis, content creation, visual understanding, agentic tool use |
| The lowest latency and price, with extended thinking | Claude Haiku 4.5 | Real-time applications, high-volume intelligent processing, cost-sensitive deployments needing strong reasoning, sub-agent tasks |
------------------------------------------------------------------------
## Decide whether to upgrade or change models
To determine if you need to upgrade or change models, you should:
1. [Create benchmark tests](/docs/en/test-and-evaluate/develop-tests) specific to your use case - having a good evaluation set is the most important step in the process.
2. Test with your actual prompts and data.
3. Compare performance across models for:
- Accuracy of responses
- Response quality
- Handling of edge cases
4. Weigh performance and cost tradeoffs.
## Combine models
Multi-model strategies pair a lower-cost model with a frontier model so that most tokens are billed at the lower rate. The two common patterns are an executor that escalates hard decisions to an advisor, and an orchestrator that delegates bulk work to lower-cost workers. See [Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence) for both strategies, measured examples, and implementation options.
## Next steps
[Model comparison chart](/docs/en/models/overview)
See detailed specifications and pricing for the latest Claude models
[What's new in Claude Fable 5.1](/docs/en/models/fable-5-1/whats-new-fable-5-1)
Built for demanding reasoning and long-horizon agentic work
[What's new in Claude Opus 5.5](/docs/en/models/opus-5-5/whats-new-opus-5-5)
The latest Opus model: breaking changes, new features, and behavior differences
[What's new in Claude Sonnet 5](/docs/en/models/sonnet-5/whats-new-sonnet-5)
For everyday workloads that balance speed and capability
[Start building](/docs/en/get-started)
Get started with your first API call
---
## about-claude-models-choosing-a-model-84da495643.md
# Choosing the right model
Selecting the optimal Claude model for your application involves balancing three key considerations: capabilities, speed, and cost. This guide helps you make an informed decision based on your specific requirements.
---
## Establish key criteria
When choosing a Claude model, consider first evaluating these factors:
- **Capabilities:** What specific features or capabilities will you need the model to have in order to meet your needs?
- **Speed:** How quickly does the model need to respond in your application? For Claude Opus 4.6, [fast mode](/docs/en/build-with-claude/fast-mode) (beta: research preview) can provide up to 2.5x higher output speed at premium pricing.
- **Cost:** What's your budget for both development and production usage?
Knowing these answers in advance will make narrowing down and deciding which model to use much easier.
***
## Choose the best model to start with
There are two general approaches you can use to start testing which Claude model best works for your needs.
### Option 1: Start with a fast, cost-effective model
For many applications, starting with a faster, more cost-effective model like Claude Haiku 4.5 can be the optimal approach:
1. Begin implementation with Claude Haiku 4.5
2. Test your use case thoroughly
3. Evaluate if performance meets your requirements
4. Upgrade only if necessary for specific capability gaps
This approach allows for quick iteration, lower development costs, and is often sufficient for many common applications. This approach is best for:
- Initial prototyping and development
- Applications with tight latency requirements
- Cost-sensitive implementations
- High-volume, straightforward tasks
### Option 2: Start with the most capable model
For complex tasks where intelligence and advanced capabilities are paramount, you may want to start with the most capable model and then consider optimizing to more efficient models down the line:
1. Implement with Claude Opus 4.7
2. Optimize your prompts for these models
3. Evaluate if performance meets your requirements
4. Consider increasing efficiency by downgrading intelligence over time with greater workflow optimization
This approach is best for:
- Complex reasoning tasks
- Scientific or mathematical applications
- Tasks requiring nuanced understanding
- Applications where accuracy outweighs cost considerations
- Advanced coding
## Model selection matrix
| When you need... | Consider starting with... | Example use cases |
|------------------|-------------------|-------------------|
| Anthropic's most capable generally available model for complex reasoning and agentic coding, with a step-change jump over Claude Opus 4.6 | Claude Opus 4.7 | Long-horizon agentic coding, large-scale refactoring, complex systems engineering, advanced research, multi-hour autonomous tasks |
| Frontier intelligence at scale, built for coding, agents, and enterprise workflows | Claude Sonnet 4.6 | Code generation, data analysis, content creation, visual understanding, agentic tool use |
| Near-frontier performance with lightning-fast speed and extended thinking at the most economical price point | Claude Haiku 4.5 | Real-time applications, high-volume intelligent processing, cost-sensitive deployments needing strong reasoning, sub-agent tasks |
***
## Decide whether to upgrade or change models
To determine if you need to upgrade or change models, you should:
1. [Create benchmark tests](/docs/en/test-and-evaluate/develop-tests) specific to your use case - having a good evaluation set is the most important step in the process
2. Test with your actual prompts and data
3. Compare performance across models for:
- Accuracy of responses
- Response quality
- Handling of edge cases
4. Weigh performance and cost tradeoffs
## Next steps
See detailed specifications and pricing for the latest Claude models
Explore the latest improvements in Claude Opus 4.7
Get started with your first API call
---
## about-claude-models-choosing-a-model.md
# Choosing the right model
Selecting the optimal Claude model for your application involves balancing three key considerations: capabilities, speed, and cost. This guide helps you make an informed decision based on your specific requirements.
Establish key criteria
When choosing a Claude model, consider first evaluating these factors:
- **Capabilities:** What specific features or capabilities will you need the model to have in order to meet your needs?
- **Speed:** How quickly does the model need to respond in your application? For Claude Opus 4.6, [fast mode](/docs/en/build-with-claude/fast-mode) (beta: research preview) can provide up to 2.5x higher output speed at premium pricing.
- **Cost:** What's your budget for both development and production usage?
Knowing these answers in advance will make narrowing down and deciding which model to use much easier.
------------------------------------------------------------------------
Choose the best model to start with
There are two general approaches you can use to start testing which Claude model best works for your needs.
Option 1: Start with a fast, cost-effective model
For many applications, starting with a faster, more cost-effective model like Claude Haiku 4.5 can be the optimal approach:
1. Begin implementation with Claude Haiku 4.5
2. Test your use case thoroughly
3. Evaluate if performance meets your requirements
4. Upgrade only if necessary for specific capability gaps
This approach allows for quick iteration, lower development costs, and is often sufficient for many common applications. This approach is best for:
- Initial prototyping and development
- Applications with tight latency requirements
- Cost-sensitive implementations
- High-volume, straightforward tasks
Option 2: Start with the most capable model
For complex tasks where intelligence and advanced capabilities are paramount, you may want to start with the most capable model and then consider optimizing to more efficient models down the line:
1. Implement with Claude Opus 4.6
2. Optimize your prompts for these models
3. Evaluate if performance meets your requirements
4. Consider increasing efficiency by downgrading intelligence over time with greater workflow optimization
This approach is best for:
- Complex reasoning tasks
- Scientific or mathematical applications
- Tasks requiring nuanced understanding
- Applications where accuracy outweighs cost considerations
- Advanced coding
Model selection matrix
| When you need... | Consider starting with... | Example use cases |
|----|----|----|
| The most intelligent model, and the world’s best model for coding, enterprise agents, and professional work. | Claude Opus 4.6 | Professional software engineering, advanced agents for office tasks, computer and browser use at scale, multi-hour research tasks, step-change vision applications |
| Frontier intelligence at scale, built for coding, agents, and enterprise workflows | Claude Sonnet 4.6 | Code generation, data analysis, content creation, visual understanding, agentic tool use |
| Near-frontier performance with lightning-fast speed and extended thinking at the most economical price point | Claude Haiku 4.5 | Real-time applications, high-volume intelligent processing, cost-sensitive deployments needing strong reasoning, sub-agent tasks |
------------------------------------------------------------------------
Decide whether to upgrade or change models
To determine if you need to upgrade or change models, you should:
1. [Create benchmark tests](/docs/en/test-and-evaluate/develop-tests) specific to your use case - having a good evaluation set is the most important step in the process
2. Test with your actual prompts and data
3. Compare performance across models for:
- Accuracy of responses
- Response quality
- Handling of edge cases
4. Weigh performance and cost tradeoffs
Next steps
Model comparison chart
See detailed specifications and pricing for the latest Claude models
What's new in Claude 4.6
Explore the latest improvements in Claude 4.6 models
Start building
Get started with your first API call
---
## about-claude-models-migrating-to-claude-4.md
This guide covers two key migration paths to Claude 4.5 models:
Claude Sonnet 3.7 → Claude Sonnet 4.5: Our most intelligent model with best-in-class reasoning, coding, and long-running agent capabilities
Claude Haiku 3.5 → Claude Haiku 4.5: Our fastest and most intelligent Haiku model with near-frontier performance for real-time applications and high-volume intelligent processing
Both migrations involve breaking changes that require updates to your implementation. This guide will walk you through each migration path with step-by-step instructions and clearly marked breaking changes.
Before starting your migration, we recommend reviewing What's new in Claude 4.5 to understand the new features and capabilities available in these models, including extended thinking, context awareness, and behavioral improvements.
Migrating from Claude Sonnet 3.7 to Claude Sonnet 4.5
Claude Sonnet 4.5 is our most intelligent model, offering best-in-class performance for reasoning, coding, and long-running autonomous agents. This migration includes several breaking changes that require updates to your implementation.
Migration steps
Update your model name:
# Before (Claude Sonnet 3.7)
model="claude-3-7-sonnet-20250219"
# After (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Update sampling parameters
This is a breaking change from the Claude Sonnet 3.7.
Use only temperature OR top_p, not both:
# Before (Claude Sonnet 3.7) - This will error in Sonnet 4.5
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # Cannot use both
...
)
# After (Claude Sonnet 4.5)
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
temperature=0.7, # Use temperature OR top_p, not both
...
)
Handle the new refusal stop reason
Update your application to handle refusal stop reasons:
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Handle refusal appropriately
pass
Update text editor tool (if applicable)
This is a breaking change from the Claude Sonnet 3.7.
Update to text_editor_20250728 (type) and str_replace_based_edit_tool (name). Remove any code using the undo_edit command.
# Before (Claude Sonnet 3.7)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# After (Claude Sonnet 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
See Text editor tool documentation for details.
Update code execution tool (if applicable)
Upgrade to code_execution_20250825. The legacy version code_execution_20250522 still works but is not recommended. See Code execution tool documentation for migration instructions.
Remove token-efficient tool use beta header
Token-efficient tool use is a beta feature that only works with Claude 3.7 Sonnet. All Claude 4 models have built-in token-efficient tool use, so you should no longer include the beta header.
Remove the token-efficient-tools-2025-02-19 beta header from your requests:
# Before (Claude Sonnet 3.7)
client.messages.create(
model="claude-3-7-sonnet-20250219",
betas=["token-efficient-tools-2025-02-19"], # Remove this
...
)
# After (Claude Sonnet 4.5)
client.messages.create(
model="claude-sonnet-4-5-20250929",
# No token-efficient-tools beta header
...
)
Remove extended output beta header
The output-128k-2025-02-19 beta header for extended output is only available in Claude Sonnet 3.7.
Remove this header from your requests:
# Before (Claude Sonnet 3.7)
client.messages.create(
model="claude-3-7-sonnet-20250219",
betas=["output-128k-2025-02-19"], # Remove this
...
)
# After (Claude Sonnet 4.5)
client.messages.create(
model="claude-sonnet-4-5-20250929",
# No output-128k beta header
...
)
Update your prompts for behavioral changes
Claude Sonnet 4.5 has a more concise, direct communication style and requires explicit direction. Review Claude 4 prompt engineering best practices for optimization guidance.
Consider enabling extended thinking for complex tasks
Enable extended thinking for significant performance improvements on coding and reasoning tasks (disabled by default):
response = client.messages.create(
model="claude-sonnet-4-5-20250929",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[...]
)
Extended thinking impacts prompt caching efficiency.
Test your implementation
Test in a development environment before deploying to production to ensure all breaking changes are properly handled.
Sonnet 3.7 → 4.5 migration checklist
Update model ID to claude-sonnet-4-5-20250929
BREAKING: Update sampling parameters to use only temperature OR top_p, not both
Handle new refusal stop reason in your application
BREAKING: Update text editor tool to text_editor_20250728 and str_replace_based_edit_tool (if applicable)
BREAKING: Remove any code using the undo_edit command (if applicable)
Update code execution tool to code_execution_20250825 (if applicable)
Remove token-efficient-tools-2025-02-19 beta header (if applicable)
Remove output-128k-2025-02-19 beta header (if applicable)
Review and update prompts following Claude 4 best practices
Consider enabling extended thinking for complex reasoning tasks
Handle model_context_window_exceeded stop reason (Sonnet 4.5 specific)
Consider enabling memory tool for long-running agents (beta)
Consider using automatic tool call clearing for context editing (beta)
Test in development environment before production deployment
Features removed from Claude Sonnet 3.7
Token-efficient tool use: The token-efficient-tools-2025-02-19 beta header only works with Claude 3.7 Sonnet and is not supported in Claude 4 models (see step 6)
Extended output: The output-128k-2025-02-19 beta header is not supported (see step 7)
Both headers can be included in Claude 4 requests but will have no effect.
Migrating from Claude Haiku 3.5 to Claude Haiku 4.5
Claude Haiku 4.5 is our fastest and most intelligent Haiku model with near-frontier performance, delivering premium model quality with real-time performance for interactive applications and high-volume intelligent processing. This migration includes several breaking changes that require updates to your implementation.
For a complete overview of new capabilities, see What's new in Claude 4.5.
Haiku 4.5 pricing $1 per million input tokens, $5 per million output tokens. See Claude pricing for details.
Migration steps
Update your model name:
# Before (Haiku 3.5)
model="claude-3-5-haiku-20241022"
# After (Haiku 4.5)
model="claude-haiku-4-5-20251001"
Update tool versions (if applicable)
This is a breaking change from the Claude Haiku 3.5.
Haiku 4.5 only supports the latest tool versions:
# Before (Haiku 3.5)
tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# After (Haiku 4.5)
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
Text editor: Use text_editor_20250728 and str_replace_based_edit_tool
Code execution: Use code_execution_20250825
Remove any code using the undo_edit command
Update sampling parameters
This is a breaking change from the Claude Haiku 3.5.
Use only temperature OR top_p, not both:
# Before (Haiku 3.5) - This will error in Haiku 4.5
response = client.messages.create(
model="claude-3-5-haiku-20241022",
temperature=0.7,
top_p=0.9, # Cannot use both
...
)
# After (Haiku 4.5)
response = client.messages.create(
model="claude-haiku-4-5-20251001",
temperature=0.7, # Use temperature OR top_p, not both
...
)
Review new rate limits
Haiku 4.5 has separate rate limits from Haiku 3.5. See Rate limits documentation for details.
Handle the new refusal stop reason
Update your application to handle refusal stop reasons.
Consider enabling extended thinking for complex tasks
Enable extended thinking for significant performance improvements on coding and reasoning tasks (disabled by default):
response = client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 5000},
messages=[...]
)
Extended thinking impacts prompt caching efficiency.
Explore new capabilities
See What's new in Claude 4.5 for details on context awareness, increased output capacity (64K tokens), higher intelligence, and improved speed.
Test your implementation
Test in a development environment before deploying to production to ensure all breaking changes are properly handled.
Haiku 3.5 → 4.5 migration checklist
Update model ID to claude-haiku-4-5-20251001
BREAKING: Update tool versions to latest (e.g., text_editor_20250728, code_execution_20250825) - legacy versions not supported
BREAKING: Remove any code using the undo_edit command (if applicable)
BREAKING: Update sampling parameters to use only temperature OR top_p, not both
Review and adjust for new rate limits (separate from Haiku 3.5)
Handle new refusal stop reason in your application
Consider enabling extended thinking for complex reasoning tasks (new capability)
Leverage context awareness for better token management in long sessions
Prepare for larger responses (max output increased from 8K to 64K tokens)
Review and update prompts following Claude 4 best practices
Test in development environment before production deployment
Choosing between Sonnet 4.5 and Haiku 4.5
Both Claude Sonnet 4.5 and Claude Haiku 4.5 are powerful Claude 4 models with different strengths:
Choose Claude Sonnet 4.5 (most intelligent) for:
Complex reasoning and analysis: Best-in-class intelligence for sophisticated tasks
Long-running autonomous agents: Superior performance for agents working independently for extended periods
Advanced coding tasks: Our strongest coding model with advanced planning and security engineering
Large context workflows: Enhanced context management with memory tool and context editing capabilities
Tasks requiring maximum capability: When intelligence and accuracy are the top priorities
Choose Claude Haiku 4.5 (fastest and most intelligent Haiku) for:
Real-time applications: Fast response times for interactive user experiences with near-frontier performance
High-volume intelligent processing: Cost-effective intelligence at scale with improved speed
Cost-sensitive deployments: Near-frontier performance at lower price points
Sub-agent architectures: Fast, intelligent agents for multi-agent systems
Computer use at scale: Cost-effective autonomous desktop and browser automation
Tasks requiring speed: When low latency is critical while maintaining near-frontier intelligence
Extended thinking recommendations
Claude 4 models, particularly Sonnet and Haiku 4.5, show significant performance improvements when using extended thinking for coding and complex reasoning tasks. Extended thinking is disabled by default but we recommend enabling it for demanding work.
Important: Extended thinking impacts prompt caching efficiency. When non-tool-result content is added to a conversation, thinking blocks are stripped from cache, which can increase costs in multi-turn conversations. We recommend enabling thinking when the performance benefits outweigh the caching trade-off.
Other migration scenarios
The primary migration paths covered above (Sonnet 3.7 → 4.5 and Haiku 3.5 → 4.5) represent the most common upgrades. However, you may be migrating from other Claude models to Claude 4.5. This section covers those scenarios.
Migrating from Claude Sonnet 4 → Sonnet 4.5
Breaking change: Cannot specify both temperature and top_p in the same request.
All other API calls will work without modification. Update your model ID and adjust sampling parameters if needed:
# Before (Claude Sonnet 4)
model="claude-sonnet-4-20250514"
# After (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Migrating from Claude Opus 4.1 → Sonnet 4.5
No breaking changes. All API calls will work without modification.
Simply update your model ID:
# Before (Claude Opus 4.1)
model="claude-opus-4-1-20250805"
# After (Claude Sonnet 4.5)
model="claude-sonnet-4-5-20250929"
Claude Sonnet 4.5 is our most intelligent model with best-in-class reasoning, coding, and long-running agent capabilities. It offers superior performance compared to Opus 4.1 for most use cases.
Migrating from Claude Opus 4.1 → Opus 4.5
No breaking changes. All API calls will work without modification.
Simply update your model ID:
# Before (Claude Opus 4.1)
model="claude-opus-4-1-20250805"
# After (Claude Opus 4.5)
model="claude-opus-4-5-20251101"
Claude Opus 4.5 is our most intelligent model, combining maximum capability with practical performance. It features step-change improvements in vision, coding, and computer use at a more accessible price point than Opus 4.1. Ideal for complex specialized tasks and professional software engineering.
For codebases with many model references, a Claude Code plugin is available to automate migration to Opus 4.5.
Migrating between Claude 4.5 models
No breaking changes. All API calls will work without modification.
Simply update your model ID.
Need help?
Check our API documentation for detailed specifications
Review model capabilities for performance comparisons
Review API release notes for API updates
Contact support if you encounter any issues during migration
---
## about-claude-models-migration-guide-4311c39782.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Fmigration-guide)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5](/docs/en/models/sonnet-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
[Models & pricing](/docs/en/models/overview)Guides
# Migration guides
Copy page
Guides for migrating to the latest Claude models from previous Claude versions
Copy page
- [Migrating to Claude Fable 5.1 and Claude Mythos 5.1](/docs/en/models/fable-5-1/migration-guide)
- [Migrating to Claude Mythos 5 and Claude Fable 5](/docs/en/models/fable-5/migration-guide)
- [Migrating to Claude Opus 5.5](/docs/en/models/opus-5-5/migration-guide)
- [Migrating to Claude Sonnet 5](/docs/en/models/sonnet-5/migration-guide)
- [Migrating to Claude Haiku 4.5](/docs/en/models/haiku-4-5/migration-guide)
## Get help
- Check the [API documentation](/docs/en/api/overview) for detailed specifications
- Review [model capabilities](/docs/en/models/overview) for performance comparisons
- Review [API release notes](/docs/en/release-notes/overview) for API updates
- Contact support if you encounter any issues during migration
---
## about-claude-models-migration-guide-6c790f7501.md
# Migration guide
Guide for migrating to Claude Opus 4.7 and Claude 4.6 models from previous Claude versions
---
This guide covers migrating [Messages API](/docs/en/build-with-claude/working-with-messages) code. If you use [Claude Managed Agents](/docs/en/managed-agents/overview), no changes beyond updating model name are required.
## Migrating to Claude Opus 4.7
Claude Opus 4.7 is our most capable generally available model to date. It is highly autonomous and performs exceptionally well on long-horizon agentic work, knowledge work, vision tasks, and memory tasks.
Claude Opus 4.7 should have strong out-of-the-box performance on existing Claude Opus 4.6 prompts and evals at the same `$5 / $25` per MTok pricing, but there are a handful of behavioral and API changes worth knowing about as you migrate. It supports the same set of features as Claude Opus 4.6, including:
- [1M token context window](/docs/en/build-with-claude/context-windows) at standard API pricing with no long-context premium
- [128k max output tokens](/docs/en/about-claude/models/overview)
- [Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking)
- [Prompt caching](/docs/en/build-with-claude/prompt-caching)
- [Batch processing](/docs/en/build-with-claude/batch-processing)
- [Files API](/docs/en/build-with-claude/files)
- [PDF support](/docs/en/build-with-claude/pdf-support)
- [Vision](/docs/en/build-with-claude/vision)
- The full set of server-side and client-side [tools](/docs/en/agents-and-tools/tool-use/overview) ([bash](/docs/en/agents-and-tools/tool-use/bash-tool), [code execution](/docs/en/agents-and-tools/tool-use/code-execution-tool), [computer use](/docs/en/agents-and-tools/tool-use/computer-use-tool), [text editor](/docs/en/agents-and-tools/tool-use/text-editor-tool), [web search](/docs/en/agents-and-tools/tool-use/web-search-tool), [web fetch](/docs/en/agents-and-tools/tool-use/web-fetch-tool), [MCP connector](/docs/en/agents-and-tools/mcp-connector), [memory](/docs/en/agents-and-tools/tool-use/memory-tool))
**Automate this migration with the Claude API skill.** In Claude Code, run `/claude-api migrate` to invoke the bundled [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model):
```text
/claude-api migrate this project to claude-opus-4-7
```
The skill applies the model ID swap, breaking parameter changes, prefill replacement, and effort calibration described below across your codebase, then produces a checklist of items to verify manually. It asks you to confirm the migration scope (entire working directory, a subdirectory, or a specific file list) before editing any files.
### Update your model name
```python
# Opus migration
model = "claude-opus-4-6" # Before
model = "claude-opus-4-7" # After
```
### Breaking changes
1. **Extended thinking removed:** `thinking: {type: "enabled", budget_tokens: N}` is no longer supported on Claude Opus 4.7 or later models and returns a 400 error. Switch to [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) (`thinking: {type: "adaptive"}`) and use the [effort parameter](/docs/en/build-with-claude/effort) to control thinking depth. Adaptive thinking is **off by default** on Claude Opus 4.7: requests with no `thinking` field run without thinking, matching Opus 4.6 behavior. Set `thinking: {type: "adaptive"}` explicitly to enable it.
Before (Claude Opus 4.6):
```python
client.messages.create(
model="claude-opus-4-6",
max_tokens=64000,
thinking={"type": "enabled", "budget_tokens": 32000},
messages=[{"role": "user", "content": "..."}],
)
```
After (Claude Opus 4.7):
```python
client.messages.create(
model="claude-opus-4-7",
max_tokens=64000,
thinking={"type": "adaptive"},
output_config={"effort": "high"}, # or "max", "xhigh", "medium", "low"
messages=[{"role": "user", "content": "..."}],
)
```
Adaptive thinking is steerable through prompting. For guidance on tuning when the model over- or under-thinks, see [Calibrating effort and thinking depth](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices#calibrating-effort-and-thinking-depth).
2. **Sampling parameters removed:** Setting `temperature`, `top_p`, or `top_k` to any non-default value on Claude Opus 4.7 returns a 400 error. The safest migration path is to omit these parameters entirely from request payloads. Prompting is the recommended way to guide model behavior on Claude Opus 4.7. If you were using `temperature = 0` for determinism, note that it never guaranteed identical outputs on prior models.
3. **Thinking content omitted by default:** Thinking blocks still appear in the response stream on Claude Opus 4.7, but their `thinking` field is empty unless you explicitly opt in. This is a silent change from Claude Opus 4.6, where the default was to return summarized thinking text. To restore summarized thinking content on Claude Opus 4.7, set `thinking.display` to `"summarized"`:
```python
thinking = {
"type": "adaptive",
"display": "summarized",
}
```
The default is `"omitted"` on Claude Opus 4.7. If your product streams reasoning to users, the new default appears as a long pause before output begins; set `display: "summarized"` to restore visible progress during thinking. See [Extended thinking](/docs/en/build-with-claude/extended-thinking#controlling-thinking-display) for details.
4. **Updated token counting:** Claude Opus 4.7 uses a new tokenizer, contributing to its improved performance on a wide range of tasks. The new tokenizer may use roughly 1x to 1.35x as many tokens when processing text compared to previous models (up to ~35% more, varying by content).
[`/v1/messages/count_tokens`](/docs/en/build-with-claude/token-counting) will return a different number of tokens for Claude Opus 4.7 than it did for Claude Opus 4.6. Token efficiency can vary by workload shape.
Prompting interventions, `task_budget`, and `effort` can help control costs and ensure appropriate token usage. These controls may trade off model intelligence. We suggest updating your `max_tokens` parameters to give additional headroom, including compaction triggers. Claude Opus 4.7 provides a 1M context window at standard API pricing with no long-context premium.
5. **Prefill removal (carried over from Opus 4.6):** Prefilling assistant messages returns a 400 error on Claude Opus 4.7. Use [structured outputs](/docs/en/build-with-claude/structured-outputs), system prompt instructions, or `output_config.format` instead.
### Choosing an effort level
The [effort parameter](/docs/en/build-with-claude/effort) allows you to tune Claude's intelligence vs. token spend, trading off capability for faster speed and lower costs. Start with the new `xhigh` effort level for coding and agentic use cases, and use a minimum of `high` effort for most intelligence-sensitive use cases. Experiment with other effort levels to further tune token usage and intelligence:
- **`max`:** Max effort can deliver performance gains in some use cases, but may show diminishing returns from increased token usage. This setting can also sometimes be prone to overthinking. We recommend testing max effort for intelligence-demanding tasks.
- **`xhigh` (new):** Extra high effort is the best setting for most coding and agentic use cases.
- **`high`:** This setting balances token usage and intelligence. For most intelligence-sensitive use cases, we recommend a minimum of `high` effort.
- **`medium`:** Good for cost-sensitive use cases that need to reduce token usage while trading off intelligence.
- **`low`:** Reserve for short, scoped tasks and latency-sensitive workloads that are not intelligence-sensitive.
We expect effort to be more important for this model than for any prior Opus, and recommend experimenting with it actively when you upgrade.
### Behavior changes
Claude Opus 4.7 has several behavioral differences from Claude Opus 4.6 that are not API breaking changes but may require prompt updates or scaffolding removal.
1. **Response length varies by use case:** Claude Opus 4.7 calibrates response length to how complex it judges the task to be, rather than defaulting to a fixed verbosity. This usually means shorter answers on simple lookups and much longer ones on open-ended analysis.
If your product depends on a certain style or verbosity of output, you may need to tune your prompts. For example, to decrease verbosity, add: "Provide concise, focused responses. Skip non-essential context, and keep examples minimal." If you see specific kinds of over-explaining, add targeted instructions in your prompt to prevent them.
Positive examples showing how Claude can communicate with the appropriate level of concision tend to be more effective than negative examples or instructions that tell the model what not to do.
2. **More literal instruction following:** Claude Opus 4.7 interprets prompts more literally and explicitly than Claude Opus 4.6, particularly at lower effort levels. It will not silently generalize an instruction from one item to another, and it will not infer requests you didn't make. The upside of this literalism is precision and less thrash. It generally performs better for API use cases with carefully tuned prompts, structured extraction, and pipelines where you want predictable behavior. A prompt and harness review may be especially helpful for migration to Claude Opus 4.7.
3. **More direct tone:** As with any new model, prose style on long-form writing may shift. Claude Opus 4.7 is more direct and opinionated, with less validation-forward phrasing and fewer emoji than Claude Opus 4.6's warmer style. If your product relies on a specific voice, re-evaluate style prompts against the new baseline.
4. **Built-in progress updates in agentic traces:** Claude Opus 4.7 provides more regular, higher-quality updates to the user throughout long agentic traces. If you've added scaffolding to force interim status messages ("After every 3 tool calls, summarize progress"), try removing it. If you find that the length or contents of Claude Opus 4.7's user-facing updates are not well-calibrated to your use case, explicitly describe what these updates should look like in the prompt and provide examples.
5. **Fewer subagents spawned by default:** Claude Opus 4.7 tends to spawn fewer subagents by default. However, this behavior is steerable through prompting; give Claude Opus 4.7 explicit guidance around when subagents are desirable.
6. **Stricter effort calibration:** Meaningfully changing from Claude Opus 4.6, Claude Opus 4.7 respects [effort levels](/docs/en/build-with-claude/effort) strictly, especially at the low end. At `low` and `medium`, the model scopes its work to what was asked rather than going above and beyond.
This is good for latency and cost, but on moderately complex tasks running at `low` effort there is some risk of under-thinking. If you observe shallow reasoning on complex problems, raise effort to `high` or `xhigh` rather than prompting around it.
If you need to keep effort at `low` for latency, add targeted guidance: "This task involves multi-step reasoning. Think carefully through the problem before responding." See [Recommended effort levels for Claude Opus 4.7](/docs/en/build-with-claude/effort#recommended-effort-levels-for-claude-opus-4-7).
7. **Fewer tool calls by default:** Claude Opus 4.7 has a tendency to use tools less often than Claude Opus 4.6 and to use reasoning more. This produces better results in most cases.
To increase tool usage, raise the effort setting. `high` or `xhigh` effort settings show substantially more tool usage in agentic search and coding. You can also adjust your prompt to explicitly instruct the model about when and how to properly use its tools.
8. **Real-time cybersecurity safeguards:** Newly added in Claude Opus 4.7, requests that involve prohibited or high-risk topics may lead to refusals. For legitimate security work such as penetration testing, vulnerability research, or red-teaming, apply to the [Cyber Verification Program](https://claude.com/form/cyber-use-case) to request reduced restrictions. See [Safeguards, warnings, and appeals](../22-Safety-Policy/safeguards-warnings-and-appeals.md) for background.
9. **High-resolution image support:** Claude Opus 4.7 is the first Claude model with high-resolution image support. Maximum image resolution is 2576 pixels on the long edge, up from 1568 pixels on prior models. This unlocks gains on vision-heavy workloads and is particularly valuable for computer use, screenshot understanding, and document analysis.
High-resolution support is automatic and requires no beta header or client-side opt-in. Two things to plan for:
- Full-resolution images can use up to approximately 3x more image tokens than on prior models (up to 4,784 tokens per image, compared to the previous cap of roughly 1,600 tokens per image). Re-budget `max_tokens` and cost expectations for image-heavy workloads, or downsample before sending if you do not need the additional fidelity.
- Pointing and bounding-box coordinates returned by the model are 1\:1 with actual image pixels on Claude Opus 4.7, so no scale-factor conversion is required.
See [High-resolution image support on Claude Opus 4.7](/docs/en/build-with-claude/vision#high-resolution-image-support-on-claude-opus-4-7) for details.
### Recommended changes
These are not required but will improve your experience:
1. **Re-evaluate `max_tokens`:** Because the same text produces a higher token count on Claude Opus 4.7, we suggest updating your `max_tokens` parameters to give additional headroom, including compaction triggers. Prompting interventions, [`task_budget`](/docs/en/build-with-claude/task-budgets), and [`effort`](/docs/en/build-with-claude/effort) can help control costs and ensure appropriate token usage.
2. **Audit token-count expectations:** Any code path that estimates tokens client-side or assumes a fixed token-to-character ratio should be re-tested against Claude Opus 4.7. Use the [Token counting endpoint](/docs/en/build-with-claude/token-counting) to verify.
3. **Adopt [task budgets](/docs/en/build-with-claude/task-budgets) (beta):** Claude Opus 4.7 introduces task budgets. These budgets let you inform Claude how many tokens it has for a full agentic loop, including thinking, tool calls, tool results, and final output. The model sees a running countdown and uses it to prioritize work and finish the task gracefully as the budget is consumed. To use, set the beta header `task-budgets-2026-03-13` and add the following to your output config:
```python
output_config = {
"effort": "high",
"task_budget": {"type": "tokens", "total": 128000},
}
```
You may need to experiment with different task budgets for your use case. If the model is given a task budget that is too restrictive, it may complete the task less thoroughly, referencing its budget as the constraint.
For open-ended agentic tasks where quality matters more than speed, do not set a task budget. Reserve task budgets for workloads where you need the model to scope its work to a token allowance. The minimum value for a task budget is 20k tokens.
A task budget is not a hard cap; it's a suggestion that the model is aware of. It differs from `max_tokens`:
- **`task_budget`:** an advisory cap across the full agentic loop. The model sees it and uses it to pace itself.
- **`max_tokens`:** a hard per-request ceiling on generated tokens. It is not passed to the model, so the model is not aware of it.
Use `task_budget` when you want the model to self-moderate, and `max_tokens` as a hard ceiling to cap usage.
4. **Set a large `max_tokens` at `max` or `xhigh` effort:** If you are running Claude Opus 4.7 at `max` or `xhigh` effort, set a large max output token budget so the model has room to think and act across its subagents and tool calls. We recommend starting at 64k tokens and tuning from there.
5. **Downsample images if high resolution is unnecessary:** Claude Opus 4.7 supports images up to 2576px / 3.75MP. High-res images use more tokens. If the additional image fidelity is unnecessary, downsample images before sending to Claude to avoid token-usage increases. See [Images and vision](/docs/en/build-with-claude/vision).
### Migration checklist
- [ ] Update model name from `claude-opus-4-6` to `claude-opus-4-7` (or update aliases).
- [ ] Remove `temperature`, `top_p`, and `top_k` from request payloads.
- [ ] Replace `thinking: {type: "enabled", budget_tokens: N}` with `thinking: {type: "adaptive"}` plus the [effort parameter](/docs/en/build-with-claude/effort).
- [ ] Remove any assistant-message prefills.
- [ ] If your UI displays thinking content, explicitly opt in to thinking summarization.
- [ ] Re-benchmark end-to-end cost and latency under the updated tokenization.
- [ ] Re-tune `max_tokens` to account for the updated tokenization.
- [ ] Re-test any client-side token-count estimations.
- [ ] If your application sends images, re-budget for [high-resolution image support](/docs/en/build-with-claude/vision#high-resolution-image-support-on-claude-opus-4-7) (up to approximately 3x more image tokens per full-resolution image). Downsample before sending if you do not need the additional fidelity.
- [ ] If you consume pointing or bounding-box coordinates from the model, remove any scale-factor conversion; coordinates are 1\:1 with actual image pixels on Claude Opus 4.7.
- [ ] Review prompts for the behavior changes above (response length, literalism, tone, progress updates, subagents, effort calibration, tool triggering, cyber safeguards, high-resolution image handling).
- [ ] Re-baseline response length with existing length-control prompts removed, then tune explicitly.
- [ ] If using `xhigh` or `max` effort, raise `max_tokens` to at least 64k as a starting point.
- [ ] Consider adopting task budgets (beta) for agentic workflows.
- [ ] If your product does legitimate security work, apply to the [Cyber Verification Program](https://claude.com/form/cyber-use-case) for access to lower restrictions on cyber content.
## Migrating to Claude Opus 4.7 from Opus 4.5 or earlier
If you are migrating from Claude Opus 4.5, Opus 4.1, or an earlier model directly to Claude Opus 4.7, apply **all of the [Opus 4.7 changes above](#migrating-to-claude-opus-4-7)** plus the cumulative changes in this section that took effect between Opus 4.5 and Opus 4.7. If you are migrating from Opus 4.6, you only need the [Opus 4.7 section above](#migrating-to-claude-opus-4-7).
### Update your model name
```python
# Opus migration
model = "claude-opus-4-5" # Before
model = "claude-opus-4-7" # After
```
### Breaking changes
1. **Prefill removal** is covered in the [Opus 4.7 breaking changes](#breaking-changes) above.
2. **Tool parameter quoting:** Claude Opus 4.6 and later models may produce slightly different JSON string escaping in tool call arguments (e.g., different handling of Unicode escapes or forward slash escaping). If you parse tool call `input` as a raw string rather than using a JSON parser, verify your parsing logic. Standard JSON parsers (like `json.loads()` or `JSON.parse()`) handle these differences automatically.
### Recommended changes
These changes improve your experience on Opus 4.7. Items marked **(required on Opus 4.7)** were optional recommendations when Opus 4.6 launched but are now mandatory; the rest remain recommended.
1. **Migrate to adaptive thinking (required on Opus 4.7):** `thinking: {type: "enabled", budget_tokens: N}` returns a 400 error on Claude Opus 4.7. Switch to `thinking: {type: "adaptive"}` and use the [effort parameter](/docs/en/build-with-claude/effort) to control thinking depth. See [Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking).
```python Before nocheck
response = client.beta.messages.create(
model="claude-opus-4-5",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 32000},
betas=["interleaved-thinking-2025-05-14"],
messages=[...],
)
```
```python After
response = client.messages.create(
model="claude-opus-4-7",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Your prompt here"}],
)
```
```bash CLI
ant messages create <<'YAML'
model: claude-opus-4-7
max_tokens: 16000
thinking:
type: adaptive
output_config:
effort: high
messages:
- role: user
content: Your prompt here
YAML
```
```typescript TypeScript hidelines={1..2}
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
const response = await client.messages.create({
model: "claude-opus-4-7",
max_tokens: 16000,
thinking: { type: "adaptive" },
output_config: { effort: "high" },
messages: [{ role: "user", content: "Your prompt here" }]
} as unknown as Anthropic.MessageCreateParamsNonStreaming);
```
```csharp C#
using Anthropic;
using Anthropic.Models.Messages;
public class Program
{
public static async Task Main(string[] args)
{
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeOpus4_7,
MaxTokens = 16000,
Thinking = new ThinkingConfigAdaptive(),
OutputConfig = new OutputConfig { Effort = Effort.High },
Messages = [new() { Role = Role.User, Content = "Your prompt here" }]
};
var response = await client.Messages.Create(parameters);
Console.WriteLine(response);
}
}
```
```go Go hidelines={1..11,-1}
package main
import (
"context"
"fmt"
"log"
"github.com/anthropics/anthropic-sdk-go"
)
func main() {
client := anthropic.NewClient()
response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeOpus4_7,
MaxTokens: 16000,
Thinking: anthropic.ThinkingConfigParamUnion{
OfAdaptive: &anthropic.ThinkingConfigAdaptiveParam{},
},
OutputConfig: anthropic.OutputConfigParam{
Effort: anthropic.OutputConfigEffortHigh,
},
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Your prompt here")),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
}
```
```java Java hidelines={1..5,8..10,-2..}
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.Model;
import com.anthropic.models.messages.OutputConfig;
import com.anthropic.models.messages.ThinkingConfigAdaptive;
public class AdaptiveThinkingExample {
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model(Model.CLAUDE_OPUS_4_7)
.maxTokens(16000L)
.thinking(ThinkingConfigAdaptive.builder().build())
.outputConfig(OutputConfig.builder()
.effort(OutputConfig.Effort.HIGH)
.build())
.addUserMessage("Your prompt here")
.build();
Message response = client.messages().create(params);
System.out.println(response);
}
}
```
```php PHP hidelines={1..4}
messages->create(
maxTokens: 16000,
messages: [['role' => 'user', 'content' => 'Your prompt here']],
model: 'claude-opus-4-7',
thinking: ['type' => 'adaptive'],
outputConfig: ['effort' => 'high'],
);
```
```ruby Ruby hidelines={1..2}
require "anthropic"
client = Anthropic::Client.new
response = client.messages.create(
model: "claude-opus-4-7",
max_tokens: 16000,
thinking: { type: "adaptive" },
output_config: { effort: "high" },
messages: [{ role: "user", content: "Your prompt here" }]
)
```
Note that the migration also moves from `client.beta.messages.create` to `client.messages.create`. Adaptive thinking and effort are GA features and do not require the beta SDK namespace or any beta headers.
2. **Remove effort beta header:** The effort parameter is now GA. Remove `betas=["effort-2025-11-24"]` from your requests.
3. **Remove fine-grained tool streaming beta header:** Fine-grained tool streaming is now GA. Remove `betas=["fine-grained-tool-streaming-2025-05-14"]` from your requests.
4. **Remove interleaved thinking beta header:** Adaptive thinking automatically enables interleaved thinking on Claude Opus 4.7, Opus 4.6, and Sonnet 4.6. Remove `betas=["interleaved-thinking-2025-05-14"]` from your requests. The header is still functional on Sonnet 4.6 with manual extended thinking, but manual mode is deprecated.
5. **Migrate to output_config.format:** If using structured outputs, update `output_format={...}` to `output_config={"format": {...}}`. The old parameter remains functional but is deprecated and will be removed in a future model release.
### Migrating from Claude 4.1 or earlier
If you're migrating from Opus 4.1, Sonnet 4 (deprecated), or earlier models directly to Claude Opus 4.7, apply the Claude Opus 4.7 changes at the top of this guide and the cumulative changes above plus the additional changes in this section.
```python
# From Opus 4.1
model = "claude-opus-4-1-20250805" # Before
model = "claude-opus-4-7" # After
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-opus-4-7" # After
# From Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # Before
model = "claude-opus-4-7" # After
```
#### Additional breaking changes
1. **Remove sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Starting with Claude Opus 4.7, setting `temperature`, `top_p`, or `top_k` to any non-default value will return a 400 error. The safest migration path is to omit these parameters entirely from requests, and to use prompting to guide the model's behavior. If you were using `temperature = 0` for determinism, note that it never guaranteed identical outputs.
```python Python nocheck
# Before - This will error in Claude 4+ models
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # Non-default sampling params return 400 on Opus 4.7
# ...
)
# After
response = client.messages.create(
model="claude-opus-4-7",
# ...
)
```
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions. Remove any code using the `undo_edit` command.
```python
# Before
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# After
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
```
- **Text editor:** Use `text_editor_20250728` and `str_replace_based_edit_tool`. See [Text editor tool documentation](/docs/en/agents-and-tools/tool-use/text-editor-tool) for details.
- **Code execution:** Upgrade to `code_execution_20250825`. See [Code execution tool documentation](/docs/en/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version) for migration instructions.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals):
```python Python nocheck
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Handle refusal appropriately
pass
```
4. **Handle the `model_context_window_exceeded` stop reason**
Claude 4.5+ models return a `model_context_window_exceeded` stop reason when generation stops due to hitting the context window limit, rather than the requested `max_tokens` limit. Update your application to handle this new stop reason:
```python Python nocheck
response = client.messages.create(...)
if response.stop_reason == "model_context_window_exceeded":
# Handle context window limit appropriately
pass
```
5. **Verify tool parameter handling (trailing newlines)**
Claude 4.5+ models preserve trailing newlines in tool call string parameters that were previously stripped. If your tools rely on exact string matching against tool call parameters, verify your logic handles trailing newlines correctly.
6. **Update your prompts for behavioral changes**
Claude 4+ models have a more concise, direct communication style and require explicit direction. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
#### Additional recommended changes
- **Remove legacy beta headers:** Remove `token-efficient-tools-2025-02-19` and `output-128k-2025-02-19`. All Claude 4+ models have built-in token-efficient tool use and these headers have no effect.
### Migration checklist (from Opus 4.5 or earlier)
- [ ] Update model ID to `claude-opus-4-7`
- [ ] Apply all [Opus 4.7 breaking changes](#migrating-to-claude-opus-4-7) (extended thinking removed, sampling parameters removed, thinking display omitted by default, updated tokenization)
- [ ] **BREAKING:** Remove assistant message prefills (returns 400 error); use structured outputs or `output_config.format` instead
- [ ] **BREAKING on Opus 4.7:** Replace `thinking: {type: "enabled", budget_tokens: N}` with `thinking: {type: "adaptive"}` plus the [effort parameter](/docs/en/build-with-claude/effort) (returns 400 on Opus 4.7)
- [ ] Verify tool call JSON parsing uses a standard JSON parser
- [ ] Remove `effort-2025-11-24` beta header (effort is now GA)
- [ ] Remove `fine-grained-tool-streaming-2025-05-14` beta header
- [ ] Remove `interleaved-thinking-2025-05-14` beta header (adaptive thinking enables interleaved thinking automatically)
- [ ] Migrate `output_format` to `output_config.format` (if applicable)
- [ ] If migrating from Claude 4.1 or earlier: remove `temperature`, `top_p`, and `top_k` (non-default values return 400 on Opus 4.7)
- [ ] If migrating from Claude 4.1 or earlier: update tool versions (`text_editor_20250728`, `code_execution_20250825`)
- [ ] If migrating from Claude 4.1 or earlier: handle `refusal` stop reason
- [ ] If migrating from Claude 4.1 or earlier: handle `model_context_window_exceeded` stop reason
- [ ] If migrating from Claude 4.1 or earlier: verify tool string parameter handling for trailing newlines
- [ ] If migrating from Claude 4.1 or earlier: remove legacy beta headers (`token-efficient-tools-2025-02-19`, `output-128k-2025-02-19`)
- [ ] Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
- [ ] Test in development environment before production deployment
---
## Migrating to Claude Sonnet 4.6
Claude Sonnet 4.6 combines strong intelligence with fast performance, featuring improved agentic search capabilities and free code execution when used with web search or web fetch. It is ideal for everyday coding, analysis, and content tasks.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Sonnet 4.6 pricing is $3 per million input tokens, $15 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Sonnet 4.5
model = "claude-sonnet-4-5" # Before
model = "claude-sonnet-4-6" # After
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-sonnet-4-6" # After
```
### Breaking changes
#### When migrating from Sonnet 4.5
1. **Prefilling assistant messages is no longer supported**
This is a breaking change when migrating from Sonnet 4.5 or earlier.
Prefilling assistant messages returns a `400` error on Sonnet 4.6. Use [structured outputs](/docs/en/build-with-claude/structured-outputs), system prompt instructions, or `output_config.format` instead.
**Common prefill use cases and migrations:**
- **Controlling output formatting** (forcing JSON/YAML output): Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or tools with enum fields for classification tasks.
- **Eliminating preambles** (removing "Here is..." phrases): Add direct instructions in the system prompt: "Respond directly without preamble. Do not start with phrases like 'Here is...', 'Based on...', etc."
- **Avoiding bad refusals:** Claude is much better at appropriate refusals now. Clear prompting in the user message without prefill should be sufficient.
- **Continuations** (resuming interrupted responses): Move the continuation to the user message: "Your previous response was interrupted and ended with `[previous_response]`. Continue from where you left off."
- **Context hydration / role consistency** (refreshing context in long conversations): Inject what were previously prefilled-assistant reminders into the user turn instead.
2. **Tool parameter JSON escaping may differ**
This is a breaking change when migrating from Sonnet 4.5 or earlier.
JSON string escaping in tool parameters may differ from previous models. Standard JSON parsers handle this automatically, but custom string-based parsing may need updates.
#### When migrating from Claude 3.x
3. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
4. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
5. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
6. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
### Recommended changes
1. **Remove `fine-grained-tool-streaming-2025-05-14` beta header:** Fine-grained tool streaming is now GA on Sonnet 4.6 and no longer requires a beta header.
2. **Migrate `output_format` to `output_config.format`:** The `output_format` parameter is deprecated. Use `output_config.format` instead.
### Migrating from Sonnet 4.5
Consider migrating from Sonnet 4.5 to Sonnet 4.6, which delivers more intelligence at the same price point.
Sonnet 4.6 defaults to an effort level of `high`, in contrast to Sonnet 4.5 which had no effort parameter. Consider adjusting the effort parameter as you migrate from Sonnet 4.5 to Sonnet 4.6. If not explicitly set, you may experience higher latency with the default effort level.
#### If you're not using extended thinking
If you're not using extended thinking on Sonnet 4.5, you can continue without it on Sonnet 4.6. You should explicitly set effort to the level appropriate for your use case. At `low` effort with thinking disabled, you can expect similar or better performance relative to Sonnet 4.5 with no extended thinking.
```bash cURL
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 8192,
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
```bash CLI
ant messages create <<'YAML'
model: claude-sonnet-4-6
max_tokens: 8192
output_config:
effort: low
messages:
- role: user
content: Your prompt here
YAML
```
```python Python
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=8192,
output_config={"effort": "low"},
messages=[{"role": "user", "content": "Your prompt here"}],
)
```
```typescript TypeScript
const response = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 8192,
output_config: { effort: "low" },
messages: [{ role: "user", content: "Your prompt here" }]
});
```
```csharp C#
using System;
using System.Threading.Tasks;
using Anthropic;
using Anthropic.Models.Messages;
class Program
{
static async Task Main(string[] args)
{
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeSonnet4_6,
MaxTokens = 8192,
OutputConfig = new OutputConfig
{
Effort = Effort.Low
},
Messages = [new() { Role = Role.User, Content = "Your prompt here" }]
};
var message = await client.Messages.Create(parameters);
Console.WriteLine(message);
}
}
```
```go Go hidelines={1..11,-1}
package main
import (
"context"
"fmt"
"log"
"github.com/anthropics/anthropic-sdk-go"
)
func main() {
client := anthropic.NewClient()
response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
Model: anthropic.Model("claude-sonnet-4-6"),
MaxTokens: 8192,
OutputConfig: anthropic.OutputConfigParam{
Effort: anthropic.OutputConfigEffortLow,
},
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Your prompt here")),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response.Content[0].Text)
}
```
```java Java hidelines={1..4,6..8,-2..}
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.OutputConfig;
public class Main {
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model("claude-sonnet-4-6")
.maxTokens(8192L)
.outputConfig(OutputConfig.builder()
.effort(OutputConfig.Effort.LOW)
.build())
.addUserMessage("Your prompt here")
.build();
Message response = client.messages().create(params);
response.content().stream()
.flatMap(block -> block.text().stream())
.forEach(textBlock -> System.out.println(textBlock.text()));
}
}
```
```php PHP hidelines={1..4}
messages->create(
maxTokens: 8192,
messages: [['role' => 'user', 'content' => 'Your prompt here']],
model: 'claude-sonnet-4-6',
outputConfig: ['effort' => 'low'],
);
echo $message->content[0]->text;
```
```ruby Ruby hidelines={1..2}
require "anthropic"
client = Anthropic::Client.new
message = client.messages.create(
model: "claude-sonnet-4-6",
max_tokens: 8192,
output_config: {
effort: "low"
},
messages: [
{ role: "user", content: "Your prompt here" }
]
)
puts message.content.first.text
```
#### If you're using extended thinking
If you're using extended thinking with `budget_tokens` on Sonnet 4.5, it is still functional on Sonnet 4.6 but is deprecated. Migrate to [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) with the [effort parameter](/docs/en/build-with-claude/effort).
##### Migrating to adaptive thinking
[Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) is the recommended replacement for `budget_tokens` on Sonnet 4.6. It is particularly well suited to the following workload patterns:
- **Autonomous multi-step agents:** coding agents that turn requirements into working software, data analysis pipelines, and bug finding where the model runs independently across many steps. Adaptive thinking lets the model calibrate its reasoning per step, staying on path over longer trajectories. For these workloads, start at `high` effort. If latency or token usage is a concern, scale down to `medium`.
- **Computer use agents:** Sonnet 4.6 achieved best-in-class accuracy on computer use evaluations using adaptive mode.
- **Bimodal workloads:** a mix of easy and hard tasks where adaptive skips thinking on simple queries and reasons deeply on complex ones.
When using adaptive thinking, evaluate `medium` and `high` effort on your tasks. The right level depends on your workload's tradeoff between quality, latency, and token usage.
```bash cURL
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 64000,
"thinking": {
"type": "adaptive"
},
"output_config": {
"effort": "medium"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
```bash CLI nocheck
ant messages create <<'YAML'
model: claude-sonnet-4-6
max_tokens: 64000
thinking:
type: adaptive
output_config:
effort: medium
messages:
- role: user
content: Your prompt here
YAML
```
```python Python nocheck
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=64000,
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
messages=[{"role": "user", "content": "Your prompt here"}],
)
```
```typescript TypeScript nocheck
const response = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 64000,
thinking: { type: "adaptive" },
output_config: { effort: "medium" },
messages: [{ role: "user", content: "Your prompt here" }]
});
```
```csharp C# nocheck
using Anthropic;
using Anthropic.Models.Messages;
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = Model.ClaudeSonnet4_6,
MaxTokens = 64000,
Thinking = new ThinkingConfigAdaptive(),
OutputConfig = new OutputConfig { Effort = Effort.Medium },
Messages = [new() { Role = Role.User, Content = "Your prompt here" }]
};
var message = await client.Messages.Create(parameters);
Console.WriteLine(message);
}
}
```
```go Go nocheck hidelines={1..11,-1}
package main
import (
"context"
"fmt"
"log"
"github.com/anthropics/anthropic-sdk-go"
)
func main() {
client := anthropic.NewClient()
response, err := client.Messages.New(context.TODO(), anthropic.MessageNewParams{
Model: "claude-sonnet-4-6",
MaxTokens: 64000,
Thinking: anthropic.ThinkingConfigParamUnion{
OfAdaptive: &anthropic.ThinkingConfigAdaptiveParam{},
},
OutputConfig: anthropic.OutputConfigParam{
Effort: anthropic.OutputConfigEffortMedium,
},
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Your prompt here")),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
}
```
```java Java nocheck hidelines={1..4,7..9,-2..}
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.OutputConfig;
import com.anthropic.models.messages.ThinkingConfigAdaptive;
public class Main {
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model("claude-sonnet-4-6")
.maxTokens(64000L)
.thinking(ThinkingConfigAdaptive.builder().build())
.outputConfig(OutputConfig.builder()
.effort(OutputConfig.Effort.MEDIUM)
.build())
.addUserMessage("Your prompt here")
.build();
Message response = client.messages().create(params);
System.out.println(response);
}
}
```
```php PHP hidelines={1..4} nocheck
messages->create(
maxTokens: 64000,
messages: [['role' => 'user', 'content' => 'Your prompt here']],
model: 'claude-sonnet-4-6',
thinking: ['type' => 'adaptive'],
outputConfig: ['effort' => 'medium'],
);
echo $message->content[0]->text;
```
```ruby Ruby nocheck hidelines={1..2}
require "anthropic"
client = Anthropic::Client.new
message = client.messages.create(
model: "claude-sonnet-4-6",
max_tokens: 64000,
thinking: {
type: "adaptive"
},
output_config: {
effort: "medium"
},
messages: [
{ role: "user", content: "Your prompt here" }
]
)
puts message
```
If you see inconsistent behavior or quality regressions with adaptive thinking, try lowering the [effort](/docs/en/build-with-claude/effort) setting or using `max_tokens` as a hard limit first. Extended thinking with `budget_tokens` is still functional on Sonnet 4.6 but is deprecated and no longer recommended.
##### Keeping budget_tokens during migration
If you need to keep `budget_tokens` temporarily while migrating, a budget around 16k tokens provides headroom for harder problems without risk of runaway token usage. This configuration is deprecated and will be removed in a future model release.
###### Coding and agentic use cases
For agentic coding, frontend design, tool-heavy workflows, and complex enterprise workflows, start with `medium` effort. If you find latency is too high, consider reducing effort to `low`. If you need higher intelligence, consider increasing effort to `high` or migrating to Opus 4.7.
```bash cURL
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: interleaved-thinking-2025-05-14" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 16384,
"thinking": {
"type": "enabled",
"budget_tokens": 16384
},
"output_config": {
"effort": "medium"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
```bash CLI
ant beta:messages create --beta interleaved-thinking-2025-05-14 <<'YAML'
model: claude-sonnet-4-6
max_tokens: 16384
thinking:
type: enabled
budget_tokens: 16384
output_config:
effort: medium
messages:
- role: user
content: Your prompt here
YAML
```
```python Python
response = client.beta.messages.create(
model="claude-sonnet-4-6",
max_tokens=16384,
thinking={"type": "enabled", "budget_tokens": 16384},
output_config={"effort": "medium"},
betas=["interleaved-thinking-2025-05-14"],
messages=[{"role": "user", "content": "Your prompt here"}],
)
```
```typescript TypeScript
const response = await client.beta.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 16384,
thinking: { type: "enabled", budget_tokens: 16384 },
output_config: { effort: "medium" },
betas: ["interleaved-thinking-2025-05-14"],
messages: [{ role: "user", content: "Your prompt here" }]
});
```
```csharp C#
using System;
using System.Threading.Tasks;
using Anthropic;
using Anthropic.Models.Beta;
using Anthropic.Models.Beta.Messages;
class Program
{
static async Task Main(string[] args)
{
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = "claude-sonnet-4-6",
MaxTokens = 16384,
Thinking = new BetaThinkingConfigEnabled { BudgetTokens = 16384 },
OutputConfig = new BetaOutputConfig
{
Effort = Effort.Medium
},
Betas = [AnthropicBeta.InterleavedThinking2025_05_14],
Messages = [new() { Role = Role.User, Content = "Your prompt here" }]
};
var message = await client.Beta.Messages.Create(parameters);
Console.WriteLine(message);
}
}
```
```go Go hidelines={1..11,-1}
package main
import (
"context"
"fmt"
"log"
"github.com/anthropics/anthropic-sdk-go"
)
func main() {
client := anthropic.NewClient()
response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{
Model: "claude-sonnet-4-6",
MaxTokens: 16384,
Thinking: anthropic.BetaThinkingConfigParamOfEnabled(16384),
OutputConfig: anthropic.BetaOutputConfigParam{
Effort: anthropic.BetaOutputConfigEffortMedium,
},
Messages: []anthropic.BetaMessageParam{
anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Your prompt here")),
},
Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaInterleavedThinking2025_05_14},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
}
```
```java Java hidelines={1..4,7..9,-2..}
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.messages.MessageCreateParams;
import com.anthropic.models.beta.messages.BetaMessage;
import com.anthropic.models.beta.messages.BetaThinkingConfigEnabled;
import com.anthropic.models.beta.messages.BetaOutputConfig;
public class Main {
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model("claude-sonnet-4-6")
.maxTokens(16384L)
.thinking(BetaThinkingConfigEnabled.builder()
.budgetTokens(16384L)
.build())
.outputConfig(BetaOutputConfig.builder()
.effort(BetaOutputConfig.Effort.MEDIUM)
.build())
.addBeta("interleaved-thinking-2025-05-14")
.addUserMessage("Your prompt here")
.build();
BetaMessage response = client.beta().messages().create(params);
System.out.println(response);
}
}
```
```php PHP hidelines={1..4}
beta->messages->create(
maxTokens: 16384,
messages: [['role' => 'user', 'content' => 'Your prompt here']],
model: 'claude-sonnet-4-6',
thinking: ['type' => 'enabled', 'budget_tokens' => 16384],
outputConfig: ['effort' => 'medium'],
betas: ['interleaved-thinking-2025-05-14'],
);
echo $message;
```
```ruby Ruby hidelines={1..2}
require "anthropic"
client = Anthropic::Client.new
message = client.beta.messages.create(
model: "claude-sonnet-4-6",
max_tokens: 16384,
thinking: {
type: "enabled",
budget_tokens: 16384
},
output_config: {
effort: "medium"
},
betas: ["interleaved-thinking-2025-05-14"],
messages: [
{ role: "user", content: "Your prompt here" }
]
)
puts message
```
###### Chat and non-coding use cases
For chat, content generation, search, classification, and other non-coding tasks, start with `low` effort with extended thinking. If you need more depth, increase effort to `medium`.
```bash cURL
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: interleaved-thinking-2025-05-14" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 8192,
"thinking": {
"type": "enabled",
"budget_tokens": 16384
},
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
```bash CLI
ant beta:messages create --beta interleaved-thinking-2025-05-14 <<'YAML'
model: claude-sonnet-4-6
max_tokens: 8192
thinking:
type: enabled
budget_tokens: 16384
output_config:
effort: low
messages:
- role: user
content: Your prompt here
YAML
```
```python Python
response = client.beta.messages.create(
model="claude-sonnet-4-6",
max_tokens=8192,
thinking={"type": "enabled", "budget_tokens": 16384},
output_config={"effort": "low"},
betas=["interleaved-thinking-2025-05-14"],
messages=[{"role": "user", "content": "Your prompt here"}],
)
```
```typescript TypeScript
const response = await client.beta.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 8192,
thinking: { type: "enabled", budget_tokens: 16384 },
output_config: { effort: "low" },
betas: ["interleaved-thinking-2025-05-14"],
messages: [{ role: "user", content: "Your prompt here" }]
});
```
```csharp C#
using System;
using System.Threading.Tasks;
using Anthropic;
using Anthropic.Models.Beta;
using Anthropic.Models.Beta.Messages;
class Program
{
static async Task Main(string[] args)
{
AnthropicClient client = new();
var parameters = new MessageCreateParams
{
Model = "claude-sonnet-4-6",
MaxTokens = 8192,
Thinking = new BetaThinkingConfigEnabled { BudgetTokens = 16384 },
OutputConfig = new BetaOutputConfig
{
Effort = Effort.Low
},
Betas = [AnthropicBeta.InterleavedThinking2025_05_14],
Messages = [new() { Role = Role.User, Content = "Your prompt here" }]
};
var message = await client.Beta.Messages.Create(parameters);
Console.WriteLine(message);
}
}
```
```go Go hidelines={1..11,-1}
package main
import (
"context"
"fmt"
"log"
"github.com/anthropics/anthropic-sdk-go"
)
func main() {
client := anthropic.NewClient()
response, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{
Model: "claude-sonnet-4-6",
MaxTokens: 8192,
Thinking: anthropic.BetaThinkingConfigParamOfEnabled(16384),
OutputConfig: anthropic.BetaOutputConfigParam{
Effort: anthropic.BetaOutputConfigEffortLow,
},
Messages: []anthropic.BetaMessageParam{
anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Your prompt here")),
},
Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaInterleavedThinking2025_05_14},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(response)
}
```
```java Java hidelines={1..4,7..9,-2..}
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.messages.MessageCreateParams;
import com.anthropic.models.beta.messages.BetaMessage;
import com.anthropic.models.beta.messages.BetaThinkingConfigEnabled;
import com.anthropic.models.beta.messages.BetaOutputConfig;
public class Main {
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
MessageCreateParams params = MessageCreateParams.builder()
.model("claude-sonnet-4-6")
.maxTokens(8192L)
.thinking(BetaThinkingConfigEnabled.builder()
.budgetTokens(16384L)
.build())
.outputConfig(BetaOutputConfig.builder()
.effort(BetaOutputConfig.Effort.LOW)
.build())
.addBeta("interleaved-thinking-2025-05-14")
.addUserMessage("Your prompt here")
.build();
BetaMessage response = client.beta().messages().create(params);
System.out.println(response);
}
}
```
```php PHP hidelines={1..4}
beta->messages->create(
maxTokens: 8192,
messages: [['role' => 'user', 'content' => 'Your prompt here']],
model: 'claude-sonnet-4-6',
thinking: ['type' => 'enabled', 'budget_tokens' => 16384],
outputConfig: ['effort' => 'low'],
betas: ['interleaved-thinking-2025-05-14'],
);
echo $message;
```
```ruby Ruby hidelines={1..2}
require "anthropic"
client = Anthropic::Client.new
message = client.beta.messages.create(
model: "claude-sonnet-4-6",
max_tokens: 8192,
thinking: {
type: "enabled",
budget_tokens: 16384
},
output_config: {
effort: "low"
},
betas: ["interleaved-thinking-2025-05-14"],
messages: [
{ role: "user", content: "Your prompt here" }
]
)
puts message
```
### Sonnet 4.6 migration checklist
- [ ] Update model ID to `claude-sonnet-4-6`
- [ ] **BREAKING:** Remove assistant message prefilling; use structured outputs or `output_config.format` instead
- [ ] **BREAKING:** Verify tool parameter JSON parsing handles escaping differences
- [ ] **BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported (if migrating from 3.x)
- [ ] **BREAKING:** Remove any code using the `undo_edit` command (if applicable)
- [ ] **BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both (if migrating from 3.x)
- [ ] Handle new `refusal` stop reason in your application
- [ ] Remove `fine-grained-tool-streaming-2025-05-14` beta header (now GA)
- [ ] Migrate `output_format` to `output_config.format`
- [ ] Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
- [ ] **Recommended:** Migrate from `thinking: {type: "enabled", budget_tokens: N}` to `thinking: {type: "adaptive"}` with the [effort parameter](/docs/en/build-with-claude/effort) (`budget_tokens` is deprecated and will be removed in a future release)
- [ ] Test in development environment before production deployment
---
## Migrating to Claude Sonnet 4.5
Claude Sonnet 4.5 combines strong intelligence with fast performance, making it ideal for everyday coding, analysis, and content tasks.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Sonnet 4.5 pricing is $3 per million input tokens, $15 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-sonnet-4-5-20250929" # After
# From Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # Before
model = "claude-sonnet-4-5-20250929" # After
```
### Breaking changes
These breaking changes apply when migrating from Claude 3.x Sonnet models.
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
4. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
### Sonnet 4.5 migration checklist
- [ ] Update model ID to `claude-sonnet-4-5-20250929`
- [ ] **BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported (if migrating from 3.x)
- [ ] **BREAKING:** Remove any code using the `undo_edit` command (if applicable)
- [ ] **BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both (if migrating from 3.x)
- [ ] Handle new `refusal` stop reason in your application
- [ ] Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
- [ ] Consider enabling extended thinking for complex reasoning tasks
- [ ] Test in development environment before production deployment
---
## Migrating to Claude Haiku 4.5
Claude Haiku 4.5 is the fastest and most intelligent Haiku model with near-frontier performance, delivering premium model quality for interactive applications and high-volume processing.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Haiku 4.5 pricing is $1 per million input tokens, $5 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Haiku 3.5
model = "claude-3-5-haiku-20241022" # Before
model = "claude-haiku-4-5-20251001" # After
```
**Review new rate limits:** Haiku 4.5 has separate rate limits from Haiku 3.5. See [Rate limits documentation](/docs/en/api/rate-limits) for details.
For significant performance improvements on coding and reasoning tasks, consider enabling extended thinking with `thinking: {type: "enabled", budget_tokens: N}`.
Extended thinking impacts [prompt caching](/docs/en/build-with-claude/prompt-caching#caching-with-thinking-blocks) efficiency.
Extended thinking is deprecated in Claude 4.6 or newer models. If using newer models, use [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) instead.
**Explore new capabilities:** See the [models overview](/docs/en/about-claude/models/overview) for details on context awareness, increased output capacity (64k tokens), higher intelligence, and improved speed.
### Breaking changes
These breaking changes apply when migrating from Claude 3.x Haiku models.
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
4. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
### Haiku 4.5 migration checklist
- [ ] Update model ID to `claude-haiku-4-5-20251001`
- [ ] **BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported
- [ ] **BREAKING:** Remove any code using the `undo_edit` command (if applicable)
- [ ] **BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both
- [ ] Handle new `refusal` stop reason in your application
- [ ] Review and adjust for new rate limits (separate from Haiku 3.5)
- [ ] Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
- [ ] Consider enabling extended thinking for complex reasoning tasks
- [ ] Test in development environment before production deployment
---
## Get help
- Check the [API documentation](/docs/en/api/overview) for detailed specifications
- Review [model capabilities](/docs/en/about-claude/models/overview) for performance comparisons
- Review [API release notes](/docs/en/release-notes/api) for API updates
- Contact support if you encounter any issues during migration
---
## about-claude-models-migration-guide.md
# Migration guide
Guide for migrating to Claude 4.6 models from previous Claude versions
Migrating to Claude 4.6
Claude Opus 4.6 is a near drop-in replacement for Claude 4.5, with a few breaking changes to be aware of. For a full list of new features, see [What's new in Claude 4.6](/docs/en/about-claude/models/whats-new-claude-4-6).
Update your model name
```python
# Opus migration
model = "claude-opus-4-5" # Before
model = "claude-opus-4-6" # After
```
Breaking changes
1. **Prefill removal:** Prefilling assistant messages returns a 400 error on Claude 4.6 models. Use [structured outputs](/docs/en/build-with-claude/structured-outputs), system prompt instructions, or `output_config.format` instead.
2. **Tool parameter quoting:** Claude 4.6 models may produce slightly different JSON string escaping in tool call arguments (e.g., different handling of Unicode escapes or forward slash escaping). If you parse tool call `input` as a raw string rather than using a JSON parser, verify your parsing logic. Standard JSON parsers (like `json.loads()` or `JSON.parse()`) handle these differences automatically.
Recommended changes
These are not required but will improve your experience:
1. **Migrate to adaptive thinking:** `thinking: {type: "enabled", budget_tokens: N}` is deprecated on Claude 4.6 models and will be removed in a future model release. Switch to `thinking: {type: "adaptive"}` and use the [effort parameter](/docs/en/build-with-claude/effort) to control thinking depth. See [Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking).
Before
``` shiki
response = client.beta.messages.create(
model="claude-opus-4-5",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 32000},
betas=["interleaved-thinking-2025-05-14"],
messages=[...],
)
```
Note that the migration also moves from `client.beta.messages.create` to `client.messages.create`. Adaptive thinking and effort are GA features and do not require the beta SDK namespace or any beta headers.
2. **Remove effort beta header:** The effort parameter is now GA. Remove `betas=["effort-2025-11-24"]` from your requests.
3. **Remove fine-grained tool streaming beta header:** Fine-grained tool streaming is now GA. Remove `betas=["fine-grained-tool-streaming-2025-05-14"]` from your requests.
4. **Remove interleaved thinking beta header (Opus 4.6 only):** Adaptive thinking automatically enables interleaved thinking on Opus 4.6. Remove `betas=["interleaved-thinking-2025-05-14"]` from your Opus 4.6 requests. Note: Sonnet 4.6 continues to support this beta header with manual extended thinking.
5. **Migrate to output_config.format:** If using structured outputs, update `output_format={...}` to `output_config={"format": {...}}`. The old parameter remains functional but is deprecated and will be removed in a future model release.
Migrating from Claude 4.1 or earlier to Claude 4.6
If you're migrating from Opus 4.1, Sonnet 4, or earlier models directly to Claude 4.6, apply the Claude 4.6 breaking changes above plus the additional changes in this section.
```python
# From Opus 4.1
model = "claude-opus-4-1-20250805" # Before
model = "claude-opus-4-6" # After
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-opus-4-6" # After
# From Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # Before
model = "claude-opus-4-6" # After
```
Additional breaking changes
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both:
``` shiki
# Before - This will error in Claude 4+ models
response = client.messages.create(
model="claude-3-7-sonnet-20250219",
temperature=0.7,
top_p=0.9, # Cannot use both
# ...
)
# After
response = client.messages.create(
model="claude-opus-4-6",
temperature=0.7, # Use temperature OR top_p, not both
# ...
)
```
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions. Remove any code using the `undo_edit` command.
``` shiki
# Before
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]
# After
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
```
- **Text editor:** Use `text_editor_20250728` and `str_replace_based_edit_tool`. See [Text editor tool documentation](/docs/en/agents-and-tools/tool-use/text-editor-tool) for details.
- **Code execution:** Upgrade to `code_execution_20250825`. See [Code execution tool documentation](/docs/en/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version) for migration instructions.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals):
``` shiki
response = client.messages.create(...)
if response.stop_reason == "refusal":
# Handle refusal appropriately
pass
```
4. **Handle the `model_context_window_exceeded` stop reason**
Claude 4.5+ models return a `model_context_window_exceeded` stop reason when generation stops due to hitting the context window limit, rather than the requested `max_tokens` limit. Update your application to handle this new stop reason:
``` shiki
response = client.messages.create(...)
if response.stop_reason == "model_context_window_exceeded":
# Handle context window limit appropriately
pass
```
5. **Verify tool parameter handling (trailing newlines)**
Claude 4.5+ models preserve trailing newlines in tool call string parameters that were previously stripped. If your tools rely on exact string matching against tool call parameters, verify your logic handles trailing newlines correctly.
6. **Update your prompts for behavioral changes**
Claude 4+ models have a more concise, direct communication style and require explicit direction. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
Additional recommended changes
- **Remove legacy beta headers:** Remove `token-efficient-tools-2025-02-19` and `output-128k-2025-02-19`. All Claude 4+ models have built-in token-efficient tool use and these headers have no effect.
Claude 4.6 migration checklist
Update model ID to `claude-opus-4-6`
**BREAKING:** Remove assistant message prefills (returns 400 error); use structured outputs or `output_config.format` instead
**Recommended:** Migrate from `thinking: {type: "enabled", budget_tokens: N}` to `thinking: {type: "adaptive"}` with the [effort parameter](/docs/en/build-with-claude/effort) (`budget_tokens` is deprecated and will be removed in a future release)
Verify tool call JSON parsing uses a standard JSON parser
Remove `effort-2025-11-24` beta header (effort is now GA)
Remove `fine-grained-tool-streaming-2025-05-14` beta header
Remove `interleaved-thinking-2025-05-14` beta header (Opus 4.6 only; Sonnet 4.6 still supports it)
Migrate `output_format` to `output_config.format` (if applicable)
If migrating from Claude 4.1 or earlier: update sampling parameters to use only `temperature` OR `top_p`
If migrating from Claude 4.1 or earlier: update tool versions (`text_editor_20250728`, `code_execution_20250825`)
If migrating from Claude 4.1 or earlier: handle `refusal` stop reason
If migrating from Claude 4.1 or earlier: handle `model_context_window_exceeded` stop reason
If migrating from Claude 4.1 or earlier: verify tool string parameter handling for trailing newlines
If migrating from Claude 4.1 or earlier: remove legacy beta headers (`token-efficient-tools-2025-02-19`, `output-128k-2025-02-19`)
Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
Test in development environment before production deployment
------------------------------------------------------------------------
Migrating to Claude Sonnet 4.6
Claude Sonnet 4.6 combines strong intelligence with fast performance, featuring improved agentic search capabilities and free code execution when used with web search or web fetch. It is ideal for everyday coding, analysis, and content tasks.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Sonnet 4.6 pricing is \$3 per million input tokens, \$15 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Sonnet 4.5
model = "claude-sonnet-4-5" # Before
model = "claude-sonnet-4-6" # After
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-sonnet-4-6" # After
```
Breaking changes
When migrating from Sonnet 4.5
1. **Prefilling assistant messages is no longer supported**
This is a breaking change when migrating from Sonnet 4.5 or earlier.
Prefilling assistant messages returns a `400` error on Sonnet 4.6. Use [structured outputs](/docs/en/build-with-claude/structured-outputs), system prompt instructions, or `output_config.format` instead.
**Common prefill use cases and migrations:**
- **Controlling output formatting** (forcing JSON/YAML output): Use [structured outputs](/docs/en/build-with-claude/structured-outputs) or tools with enum fields for classification tasks.
- **Eliminating preambles** (removing "Here is..." phrases): Add direct instructions in the system prompt: "Respond directly without preamble. Do not start with phrases like 'Here is...', 'Based on...', etc."
- **Avoiding bad refusals:** Claude is much better at appropriate refusals now. Clear prompting in the user message without prefill should be sufficient.
- **Continuations** (resuming interrupted responses): Move the continuation to the user message: "Your previous response was interrupted and ended with `[previous_response]`. Continue from where you left off."
- **Context hydration / role consistency** (refreshing context in long conversations): Inject what were previously prefilled-assistant reminders into the user turn instead.
2. **Tool parameter JSON escaping may differ**
This is a breaking change when migrating from Sonnet 4.5 or earlier.
JSON string escaping in tool parameters may differ from previous models. Standard JSON parsers handle this automatically, but custom string-based parsing may need updates.
When migrating from Claude 3.x
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
4. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
Recommended changes
1. **Remove `fine-grained-tool-streaming-2025-05-14` beta header:** Fine-grained tool streaming is now GA on Sonnet 4.6 and no longer requires a beta header.
2. **Migrate `output_format` to `output_config.format`:** The `output_format` parameter is deprecated. Use `output_config.format` instead.
Migrating from Sonnet 4.5
Consider migrating from Sonnet 4.5 to Sonnet 4.6, which delivers more intelligence at the same price point.
Sonnet 4.6 defaults to an effort level of `high`, in contrast to Sonnet 4.5 which had no effort parameter. Consider adjusting the effort parameter as you migrate from Sonnet 4.5 to Sonnet 4.6. If not explicitly set, you may experience higher latency with the default effort level.
If you're not using extended thinking
If you're not using extended thinking on Sonnet 4.5, you can continue without it on Sonnet 4.6. You should explicitly set effort to the level appropriate for your use case. At `low` effort with thinking disabled, you can expect similar or better performance relative to Sonnet 4.5 with no extended thinking.
Shell
```python
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 8192,
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
If you're using extended thinking
If you're using extended thinking on Sonnet 4.5, it continues to be supported on Sonnet 4.6 with no changes needed to your thinking configuration. Consider keeping a thinking budget around 16k tokens. In practice, most tasks don't use that much, but it provides headroom for harder problems without risk of runaway token usage.
##### Coding and agentic use cases
For agentic coding, frontend design, tool-heavy workflows, and complex enterprise workflows, start with `medium` effort. If you find latency is too high, consider reducing effort to `low`. If you need higher intelligence, consider increasing effort to `high` or migrating to Opus 4.6.
Shell
```python
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: interleaved-thinking-2025-05-14" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 16384,
"thinking": {
"type": "enabled",
"budget_tokens": 16384
},
"output_config": {
"effort": "medium"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
##### Chat and non-coding use cases
For chat, content generation, search, classification, and other non-coding tasks, start with `low` effort with extended thinking. If you need more depth, increase effort to `medium`.
Shell
```python
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: interleaved-thinking-2025-05-14" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 8192,
"thinking": {
"type": "enabled",
"budget_tokens": 16384
},
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
##### When to try adaptive thinking
The migration paths above use extended thinking with `budget_tokens` for predictable token usage. If your workload fits one of the following patterns, consider trying [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) instead:
- **Autonomous multi-step agents:** coding agents that turn requirements into working software, data analysis pipelines, and bug finding where the model runs independently across many steps. Adaptive thinking lets the model calibrate its reasoning per step, staying on path over longer trajectories. For these workloads, start at `high` effort. If latency or token usage is a concern, scale down to `medium`.
- **Computer use agents:** Sonnet 4.6 achieved best-in-class accuracy on computer use evaluations using adaptive mode.
- **Bimodal workloads:** a mix of easy and hard tasks where adaptive skips thinking on simple queries and reasons deeply on complex ones.
When using adaptive thinking, evaluate `medium` and `high` effort on your tasks. The right level depends on your workload's tradeoff between quality, latency, and token usage.
Shell
```python
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data \
'{
"model": "claude-sonnet-4-6",
"max_tokens": 64000,
"thinking": {
"type": "adaptive"
},
"output_config": {
"effort": "medium"
},
"messages": [
{
"role": "user",
"content": "Your prompt here"
}
]
}'
```
If you see inconsistent behavior or quality regressions with adaptive thinking, switch to extended thinking with `budget_tokens`. This provides more predictable results with a cap on thinking costs.
Sonnet 4.6 migration checklist
Update model ID to `claude-sonnet-4-6`
**BREAKING:** Remove assistant message prefilling; use structured outputs or `output_config.format` instead
**BREAKING:** Verify tool parameter JSON parsing handles escaping differences
**BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported (if migrating from 3.x)
**BREAKING:** Remove any code using the `undo_edit` command (if applicable)
**BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both (if migrating from 3.x)
Handle new `refusal` stop reason in your application
Remove `fine-grained-tool-streaming-2025-05-14` beta header (now GA)
Migrate `output_format` to `output_config.format`
Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
Consider enabling extended thinking or adaptive thinking for complex reasoning tasks
Test in development environment before production deployment
------------------------------------------------------------------------
Migrating to Claude Sonnet 4.5
Claude Sonnet 4.5 combines strong intelligence with fast performance, making it ideal for everyday coding, analysis, and content tasks.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Sonnet 4.5 pricing is \$3 per million input tokens, \$15 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Sonnet 4
model = "claude-sonnet-4-20250514" # Before
model = "claude-sonnet-4-5-20250929" # After
# From Sonnet 3.7
model = "claude-3-7-sonnet-20250219" # Before
model = "claude-sonnet-4-5-20250929" # After
```
Breaking changes
These breaking changes apply when migrating from Claude 3.x Sonnet models.
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
4. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
Sonnet 4.5 migration checklist
Update model ID to `claude-sonnet-4-5-20250929`
**BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported (if migrating from 3.x)
**BREAKING:** Remove any code using the `undo_edit` command (if applicable)
**BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both (if migrating from 3.x)
Handle new `refusal` stop reason in your application
Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
Consider enabling extended thinking for complex reasoning tasks
Test in development environment before production deployment
------------------------------------------------------------------------
Migrating to Claude Haiku 4.5
Claude Haiku 4.5 is the fastest and most intelligent Haiku model with near-frontier performance, delivering premium model quality for interactive applications and high-volume processing.
For a complete overview of capabilities, see the [models overview](/docs/en/about-claude/models/overview).
Haiku 4.5 pricing is \$1 per million input tokens, \$5 per million output tokens. See [Claude pricing](/docs/en/about-claude/pricing) for details.
**Update your model name:**
```python
# From Haiku 3.5
model = "claude-3-5-haiku-20241022" # Before
model = "claude-haiku-4-5-20251001" # After
# From Haiku 3
model = "claude-3-haiku-20240307" # Before
model = "claude-haiku-4-5-20251001" # After
```
**Review new rate limits:** Haiku 4.5 has separate rate limits from Haiku 3.5 and Haiku 3. See [Rate limits documentation](/docs/en/api/rate-limits) for details.
For significant performance improvements on coding and reasoning tasks, consider enabling extended thinking with `thinking: {type: "enabled", budget_tokens: N}`.
Extended thinking impacts [prompt caching](/docs/en/build-with-claude/prompt-caching#caching-with-thinking-blocks) efficiency.
Extended thinking is deprecated in Claude 4.6 or newer models. If using newer models, use [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) instead.
**Explore new capabilities:** See the [models overview](/docs/en/about-claude/models/overview) for details on context awareness, increased output capacity (64k tokens), higher intelligence, and improved speed.
Breaking changes
These breaking changes apply when migrating from Claude 3.x Haiku models.
1. **Update sampling parameters**
This is a breaking change when migrating from Claude 3.x models.
Use only `temperature` OR `top_p`, not both.
2. **Update tool versions**
This is a breaking change when migrating from Claude 3.x models.
Update to the latest tool versions (`text_editor_20250728`, `code_execution_20250825`). Remove any code using the `undo_edit` command.
3. **Handle the `refusal` stop reason**
Update your application to [handle `refusal` stop reasons](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals).
4. **Update your prompts for behavioral changes**
Claude 4 models have a more concise, direct communication style. Review [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for optimization guidance.
Haiku 4.5 migration checklist
Update model ID to `claude-haiku-4-5-20251001`
**BREAKING:** Update tool versions to latest (`text_editor_20250728`, `code_execution_20250825`); legacy versions are not supported
**BREAKING:** Remove any code using the `undo_edit` command (if applicable)
**BREAKING:** Update sampling parameters to use only `temperature` OR `top_p`, not both
Handle new `refusal` stop reason in your application
Review and adjust for new rate limits (separate from Haiku 3.5)
Review and update prompts following [prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices)
Consider enabling extended thinking for complex reasoning tasks
Test in development environment before production deployment
------------------------------------------------------------------------
Get help
- Check the [API documentation](/docs/en/api/overview) for detailed specifications
- Review [model capabilities](/docs/en/about-claude/models/overview) for performance comparisons
- Review [API release notes](/docs/en/release-notes/api) for API updates
- Contact support if you encounter any issues during migration
---
## about-claude-models-model-ids-and-versions-9332683246.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Fmodel-ids-and-versions)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5](/docs/en/models/sonnet-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
[Models & pricing](/docs/en/models/overview)Lifecycle and reference
# Model IDs and versioning
Copy page
How Claude model IDs are structured and versioned, including the dateless format introduced with the Claude 4.6 generation and what it means for stability.
Copy page
Each Claude model ID identifies a pinned version of the model. When you use a model ID in an API request, the underlying model remains constant for the lifetime of that ID. This guarantee covers model IDs, not the convenience aliases that the Claude API accepts for some earlier models (see [Before the 4.6 generation](#before-the-4-6-generation)).
## Model ID format
Claude model IDs follow a versioned naming scheme.
### The 4.6 generation and later
Starting with the Claude 4.6 generation, model IDs use a dateless format:
``` block
claude-{name}-{major}[-{minor}]
```
Major-version releases such as Claude Sonnet 5 and Claude Opus 5 omit the minor segment.
For example: `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, and `claude-opus-5`
On Amazon Bedrock, the corresponding format is:
``` block
anthropic.claude-{name}-{major}[-{minor}]
```
For example: `anthropic.claude-sonnet-4-6`, `anthropic.claude-sonnet-5`, `anthropic.claude-opus-4-7`, `anthropic.claude-opus-4-8`, `anthropic.claude-opus-5`
Claude Opus 4.6 is the last Bedrock model ID to include the `-v1` suffix (`anthropic.claude-opus-4-6-v1`). Anthropic dropped the suffix starting with Claude Sonnet 4.6.
On Google Cloud, the format matches the Claude API.
### Before the 4.6 generation
Models before the 4.6 generation include a snapshot date in the ID:
``` block
claude-{name}-{major}-{minor}-{YYYYMMDD}
```
For example: `claude-sonnet-4-5-20250929`, `claude-haiku-4-5-20251001`
On Amazon Bedrock, these use the format:
``` block
anthropic.claude-{name}-{major}-{minor}-{YYYYMMDD}-v1:0
```
For example: `anthropic.claude-sonnet-4-5-20250929-v1:0`
On Google Cloud, the date is separated with `@`:
``` block
claude-{name}-{major}-{minor}@{YYYYMMDD}
```
For example: `claude-haiku-4-5@20251001`
On the Claude API, these models also have shorter aliases (for example, `claude-sonnet-4-5`) that point to the most recent dated snapshot for that minor version.
## Dateless IDs are pinned snapshots
A common misconception is that dateless model IDs such as `claude-sonnet-4-6` behave as evergreen pointers that route to the latest or best-performing version. That is not the case.
For the 4.6 generation and later, the dateless ID is the canonical model ID for that release. It maps to a single, fixed model snapshot. Anthropic does not update the weights or configuration of an existing model ID. When an updated version is available, it ships under a new model ID.
This differs from the dateless aliases that exist on the Claude API for earlier models. An alias such as `claude-sonnet-4-5` is a convenience pointer that resolves to the most recent dated snapshot for that minor version. A 4.6-generation ID such as `claude-sonnet-4-6` is not an alias. It is the snapshot.
Every model ID, whether dated or dateless, has its own distinct deprecation and retirement schedule.
## Model weights versus serving infrastructure
Model weights are fixed for a given ID, but the serving infrastructure around the model can change over time. This infrastructure includes components such as the request router, safety classifiers, and sampling logic.
Occasionally, infrastructure updates produce minor differences in observable behavior even when the model ID and weights have not changed. If you notice unexpected behavioral differences on a previously stable model ID, an infrastructure update is the most likely cause.
## Current model IDs
For the full list of current model IDs and their Amazon Bedrock and Google Cloud equivalents, see [Models overview](/docs/en/models/overview).
---
## about-claude-models-optimizing-for-cost-and-intelligence-5492096e7c.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [SDKs, CLI, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Foptimizing-for-cost-and-intelligence)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5.5](/docs/en/models/sonnet-5-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
[Models & pricing](/docs/en/models/overview)Guides
# Optimizing for cost and intelligence
Copy page
Balance cost and intelligence on the Claude Platform, with measured results for prompt caching, effort, model choice, budgets, and multi-model strategies.
Copy page
When a workload moves from prototype to production, cost becomes a first-class design constraint. The most capable model can be too expensive at scale, and the least expensive model can fall short on quality. Managing cost well means understanding how each cost lever affects output quality, because some levers trade against quality and some don't. The Claude Platform gives you direct control over that tradeoff. You choose the model, the effort level, and the architecture for each request, which lets you place a workload almost anywhere on the cost-to-intelligence frontier.
Cost and intelligence are usually pictured as a frontier where one buys the other. The first group of levers on this page moves a workload toward that frontier by cutting cost without touching quality; only the second group moves along it:
The levers come in two kinds:
- **Free wins** cut spend without touching quality: prompt caching, token hygiene, a prompt audit against the model you are running, [batch processing](/docs/en/build-with-claude/batch-processing) at 50% off for work that can wait up to 24 hours, and [workspace spend limits](/docs/en/api/rate-limits#setting-lower-limits-for-workspaces) as the backstop.
- **Tradeoffs** exchange cost for intelligence: model choice, effort, output caps and task budgets, an elapsed-time clock, and multi-model architectures.
Each lever comes with measured results and the rule for when it pays. In Anthropic's measurements, prompt caching was the largest lever by a wide margin: it cut agent-loop cost by a factor of 2.7 to 5.3 on this guide's benchmarks and cut a small triage agent's bill by 83%, or 88% with input trimming added. The multi-model levers are narrower; a second model paid off in two shapes, an advisor and an orchestrator.
## Start here
Match your situation to a row.
| Your situation | Do this | Where |
|:-------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------|
| Any workload, any model | Turn on prompt caching and trim unneeded tokens; both are free | [Cache repeated context](#cache-repeated-context) · [Trim tokens](#trim-input-and-context-tokens) |
| A person waits between turns | Use the 1-hour cache duration once about 1 turn in 20 follows a pause between 5 minutes and an hour and few gaps run over an hour. On Claude Fable 5.1, keep the 5-minute cache warm while pauses run minutes, and buy the 1-hour duration when pauses run toward an hour. On Claude Opus 5.5, keep the 5-minute cache warm instead when only a turn or two in 20 follow a pause of up to about half an hour | [Pick the cache duration](#pick-the-cache-duration) |
| Costs are too high; quality is fine | Sweep effort down on your current model | [Tune effort](#tune-effort) |
| You are not on the latest model | Upgrade; in Anthropic's measurements each newer model solved at least as many tasks as the one before it, usually for less per solved task | [Upgrade the model](#upgrade-the-model) |
| You are choosing or switching models | Compare on cost per completed task, not per token | [Compare models](#compare-models-on-cost-per-task) |
| Quality isn't good enough | If you lowered effort, restore it; otherwise try the next tier up at `low` effort | [Tune effort](#tune-effort) · [Compare models](#compare-models-on-cost-per-task) |
| Attempts end with `stop_reason: max_tokens` | Raise `max_tokens`; 64,000 covered all but 2 of 14,000 turns measured at the default effort, and 128,000 cost nothing extra per solved task | [Set budgets](#set-budgets-and-output-caps) |
| You can check outputs (tests, a verifier) | Run everything at low effort and re-run failures at `high`; on the coding benchmark measured, the pass rate held at about half the cost | [Re-run failures](#re-run-failures-at-higher-effort) |
| Agent loops with a few very costly runs | Set a task budget (beta; check the support table for which models), a Claude Managed Agents session budget, and a workspace spend limit | [Set budgets](#set-budgets-and-output-caps) |
| You want agent runs to finish sooner | Tell the model that time matters, and show it the elapsed time; on DRACO, HLE, and an internal physics set, runs took 33% to 69% less time at a 28% to 54% lower cost per task, with scores up to 1.9 points lower | [Show the model elapsed time](#show-the-model-elapsed-time) |
| A lower-cost model stalls only on hard decisions | Add a frontier advisor. It pays off when priced well above the executor and actually consulted, so first price the advisor's model alone at low effort and measure the consult rate | [Advisor strategy](#advisor-strategy-escalate-hard-decisions) |
| The work exceeds one context window | Delegate partitions to cheaper workers | [Orchestrator strategy](#orchestrator-strategy-delegate-bulk-work) |
These results are Anthropic-internal ([Benchmarks referenced](#refs)) and directional, not guarantees, so measure on your own workload with the [four-step method](#measure-on-your-own-workload).
## Cut spend without losing quality
Prompt caching, token hygiene, batch processing, and a prompt audit against your current model all lower what you pay without lowering output quality. Two caveats apply: batch processing trades latency for its discount, and context editing, a token-hygiene lever, cost more than it saved in the run measured in this section.
### Cache repeated context
#### Why caching comes first
Turn on [prompt caching](/docs/en/build-with-claude/prompt-caching) before any other lever, because every turn of an agentic task resends the entire growing conversation: system prompt, tool definitions, and every prior turn. A 40-turn task sends its first turn 40 times, so task cost grows with roughly the square of turn count. Caching does not stop the resending, but each resend costs about a tenth as much and processes faster: the prefix is billed at the [cache-read rate](/docs/en/build-with-claude/prompt-caching#pricing), a tenth of the input price, and each turn pays the 1.25x cache-write rate only for what is new.
**What good looks like.** Over a full day of real traffic, agent loops read a median 84% of their input from the cache, and the top 10% of harnesses, coding or not, read 94% or more^([17](#refs)). Deep in a task, a well-built loop pays full price on under 1% of its input. Below about 80%, look for something breaking the cache (see [What breaks the cache](#what-breaks-the-cache)).
Across Anthropic's measured runs, cache reads are routinely the largest single component of task cost, making caching worth more than most model-choice decisions. Anthropic priced the DeepResearch Bench II^([7](#refs)) runs with and without caching:
The cache's default lifetime is 5 minutes and an agent loop's turns are seconds apart, so the discount applies to most tokens on every turn. The caching chart's runs read 79% to 90% of their input tokens from the cache. The saving varies with episode depth, because shorter loops re-read less, but caching stayed the largest single lever on every model and benchmark measured.
#### Pick the cache duration
If your loop waits on a person between turns, use the [1-hour cache duration](/docs/en/build-with-claude/prompt-caching#1-hour-cache-duration). It costs more to write (2x the input price instead of 1.25x). A miss on either duration bills the whole prefix at the write price instead of the read price, so the longer duration pays off once a few turns per session follow a pause between 5 minutes and an hour.
To decide, count the gaps between consecutive requests in a conversation:
- More than about 1 gap in 20 falls between 5 minutes and an hour, and gaps over an hour are rare: use the 1-hour duration. On Claude Opus 5.5, when only 1 or 2 gaps in 20 fall in that range and none lasts more than about half an hour, keep the 5-minute cache warm instead, with the keep-alive requests described below.
- Turns arrive seconds apart: stay on the 5-minute default. When nothing paused, it cost 15% less than the 1-hour setting on Claude Sonnet 5 and about 15% to 18% less on Claude Opus 5.5.
- Gaps over an hour are common: stay on the default. A gap over an hour expires both durations, and the 1-hour setting then re-writes the prefix at its higher write price, so it loses on each of those gaps. Of your pauses longer than 5 minutes, if about 60% or more also run past an hour, stay on the default; the 1-hour duration pays only when at least about 40% of long pauses end within the hour.
Anthropic measured the triage job from [Trim input and context tokens](#trim-input-and-context-tokens) with pauses inserted before some turns to simulate a person's delay^([16](#refs)). On Claude Sonnet 5 and Claude Opus 5.5, the 1-hour cache became the cheaper setting once about 1 turn in 30 followed a pause, so the 1-in-20 rule leaves a margin, and the gap widens quickly past the crossover because every paused turn on the 5-minute setting re-writes the whole prefix. Every current model uses the same cache-write multipliers, and every model but Claude Fable 5.1, Claude Mythos 5.1, and Claude Opus 5.5 the same read price, so the crossover is in the same range on the other models; Fable 5.1 is the case covered next. Accuracy stayed within run-to-run noise in every cell. The turn after a pause kept its warm-cache latency on the 1-hour setting (measured on Claude Sonnet 5 and Claude Opus 5, not on Claude Opus 5.5). The following chart plots cost per session against the share of paused turns on Claude Sonnet 5:
Anthropic also measured extra requests that keep the 5-minute cache warm. On Claude Sonnet 5 they cost about 8% less than the 1-hour duration when 1 turn in 20 followed a pause, but about the same at 2 in 20; on Claude Opus 5, the previous Opus model, they saved nothing measurable. With a pause of 6 minutes or more before every turn they cost more on both models. Because the Claude Sonnet 5 saving was gone by 2 turns in 20, use the 1-hour duration instead on Claude Sonnet 5 and Claude Opus 5.
On Claude Fable 5.1 the cheapest setting is a different one. Its [cache read](/docs/en/about-claude/pricing#prompt-caching) costs 0.025x the input price (\$0.25 per million tokens) while its cache writes keep the standard multipliers, so a keep-alive request that re-reads the prefix is cheap and the 1-hour duration's write premium is the larger bill. Anthropic measured the triage job on Claude Fable 5.1 with the same three settings^([19](#refs)). Keeping the 5-minute cache warm cost 13% to 20% less per session than the 1-hour cache whenever pauses ran for minutes; only with pauses near 45 minutes did the 1-hour cache win, by about 12 cents a session. On Claude Fable 5.1, keep the 5-minute cache warm while a person is away for minutes, and buy the 1-hour duration when pauses run toward an hour:
On Claude Opus 5.5, whose cache read costs 0.05x the input price, keep-alive requests cost 8% to 13% less than the 1-hour duration when 5% or 10% of turns followed a pause of 6 to 32 minutes (at the default effort, `medium`; 10% to 18% less at `high`), but more with a pause before every turn: about 4% to 6% more at 6-minute pauses, rising to over 50% more at 45-minute pauses. So on Claude Opus 5.5, keep the 5-minute cache warm when only a turn or two in 20 follow a pause of up to about half an hour, and otherwise follow the list at the start of this section. These measurements sent keep-alive requests with `max_tokens: 1`. For the `max_tokens: 0` request described next, Anthropic's pre-launch API tests on Claude Opus 5.5 show that it writes the cache and that the next request reads it; whether it refreshes an existing entry was not measured on Opus 5.5.
To keep the cache warm, send the previous request again with `max_tokens` set to 0 within 4 minutes of the previous request's start, and every 4 minutes after that, dropping `stream` if it was set. Count from the request's start, not its response's end: the [cache's 5-minute lifetime](/docs/en/build-with-claude/prompt-caching#how-prompt-caching-works) runs from the start of the request that wrote or refreshed the entry, so time the response spent generating counts against it. That is the [pre-warming request](/docs/en/build-with-claude/prompt-caching#pre-warming-the-cache): it refreshes the cache's lifetime, generates nothing, and bills only the cache read. Do not change a byte of the prefix, and do not use `max_tokens: 1`, which samples a token for no reason. Re-send the request's headers as well as its body: if your requests carry an `anthropic-beta` header (for a [task budget](/docs/en/build-with-claude/task-budgets), say), the keep-alive request needs the same header, or the beta-gated fields in the replayed body are rejected. A `max_tokens: 0` request is rejected when the request sets `thinking.type: "enabled"` (the default adaptive thinking on Claude Fable 5.1 is fine), structured outputs, or a forced tool choice ([its limitations](/docs/en/build-with-claude/prompt-caching#limitations)); on those workloads, buy the 1-hour duration instead. A `max_tokens: 0` request is also rejected when it carries the top-level `compaction` parameter, so don't re-send a compaction request from [compaction on demand](/docs/en/build-with-claude/compaction-on-demand) as a keep-alive request.
cURL
```python
# Within 4 minutes of the last request's start (time spent generating counts
# against the cache's lifetime), re-send that request with max_tokens set to
# 0, dropping stream (a max_tokens: 0 request cannot stream). Send the same
# headers as the original request, including any anthropic-beta header.
jq '.max_tokens = 0 | del(.stream)' last_request.json | \
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
--data-binary @-
```
#### Turn on caching
Setup takes little work. [Automatic caching](/docs/en/build-with-claude/prompt-caching#automatic-caching) places breakpoints for you; otherwise, the [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill) that ships with Claude Code can add caching to an existing integration from one prompt. The following excerpt shows the skill adding it to the harness that produced these measurements:
``` block
$ claude
> /claude-api add prompt caching to this integration
Done. Prompt caching is now wired into the harness. Two changes:
- build_system() now adds cache_control: {"type": "ephemeral"} to the
system block. Since the API renders tools -> system -> messages, this
one breakpoint caches the entire static prefix -- the full tool array
plus the system prompt.
- apply_moving_cache_breakpoints() strips any stale markers, then marks
the last content block of the two most recent user turns. The older
marker is the read point matching the prefix the previous request
cached; the newer one extends the cache for the next request.
That's 3 breakpoints total, under the limit of 4.
...
```
Those breakpoint placements follow the standard pattern in [Explicit cache breakpoints](/docs/en/build-with-claude/prompt-caching#explicit-cache-breakpoints).
#### What breaks the cache
Several things can break your cache during a task. Anything that changes per request, such as a timestamp or a queue position, placed ahead of the stable prefix turns every request into a full cache write: on the triage run in [Trim input and context tokens](#trim-input-and-context-tokens), a 25-token status line at the front of the system prompt cost \$4.24 per run instead of \$0.59, more than running with caching off. Keep per-request text in the newest user turn.
The cache is a byte-exact prefix match over the request in order (tools, then system prompt, then messages), so a change anywhere invalidates everything after it. Changing [`effort`](/docs/en/build-with-claude/effort) or the thinking configuration between requests invalidates the cache from that point onward, and on some models the tools and system prompt ahead of it as well; any edit to the system prompt invalidates the cache from that point onward; setting or changing an output format invalidates the cache for the whole conversation; adding, removing, or reordering a tool definition invalidates all of it. The [prompt caching](/docs/en/build-with-claude/prompt-caching#what-invalidates-the-cache) page lists these cases, apart from the output format, which [structured outputs](/docs/en/build-with-claude/structured-outputs#prompt-modification-and-token-costs) covers. On the most recent models, change instructions with a [mid-conversation system message](/docs/en/build-with-claude/mid-conversation-system-messages), a `{"role": "system"}` message appended to `messages`, instead of editing the top-level `system` field: the cached prefix stays intact. Check that page for which models support it. On models that support it, a [per-message effort change](/docs/en/build-with-claude/effort#change-effort-mid-conversation-beta) leaves the cached prefix intact too. The stakes are highest on Claude Fable 5.1 and Claude Mythos 5.1, where a break re-writes the prefix at 1.25x the input price instead of reading it at 0.025x. On a 100,000-token prefix, one broken turn there costs \$1.25 instead of \$0.03, 50 times the read; on Claude Opus 5.5 it costs \$0.50 instead of \$0.02, 25 times, and on the other current models 12.5 times.
Anthropic measured this on the triage agent's long sessions^([18](#refs)). An effort change and an added tool made mid-session rewrote 39,000 and 60,000 cached tokens, and those sessions cost \$0.95 per session. The same two changes on the first request after compaction cost \$0.75, and on the request that triggered the compaction \$0.92, because the compaction's summarization pass then re-processed the 81,000-token context at the cache-write price: that summarization pass cost \$0.21, against \$0.04 when the same changes came one request later, with accuracy within run-to-run noise in every arm:
Changing a [task budget](/docs/en/build-with-claude/task-budgets) partway through invalidates any cached prefix that contains the budget value, so set it once, on the first request. Every [context editing](/docs/en/build-with-claude/context-editing#context-editing-and-prompt-caching) pass invalidates the prefix from the point it clears and the next request pays to re-cache everything after it, so clear in a few large batches rather than many small ones. On Claude Fable 5.1 and Claude Mythos 5.1 each of these costs 50 times the read price per token, so they matter most there. Make every cache-invalidating change at natural breaks, then confirm cache reads have not dropped; if they have, [cache diagnostics](/docs/en/build-with-claude/cache-diagnostics) shows where the prefix diverged.
### Trim input and context tokens
Most agent requests carry tokens that never influence the answer. Trimming them rarely costs output quality, although not every lever here saved money when measured. Two places to look:
- **Input trimming.** [Dynamic filtering](/docs/en/agents-and-tools/tool-use/web-fetch-tool#dynamic-filtering) in the web fetch tool keeps boilerplate out of fetched pages, [image resizing](/docs/en/build-with-claude/vision#evaluate-image-size) right-sizes vision inputs, and [tool search with deferred loading](/docs/en/agents-and-tools/tool-use/tool-search-tool) loads tool definitions only when needed (measured later in this section). [Programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) lets Claude run several tool calls from code so only the filtered result enters the context; its documentation reports 24% fewer input tokens on agentic search benchmarks, with a higher score. [Manage tool context](/docs/en/agents-and-tools/tool-use/manage-tool-context) compares tool search, programmatic tool calling, prompt caching, and context editing.
- **Context lifecycle.** [Context editing](/docs/en/build-with-claude/context-editing) clears stale tool results, and [automatic compaction](/docs/en/build-with-claude/compaction-threshold) with its threshold stops long loops from carrying their whole history forward.
The levers interact with the cache and each other, so judge them by net effect, and use [cache diagnostics](/docs/en/build-with-claude/cache-diagnostics) to confirm your cached prefix survives each change. Anthropic measured them on an issue-triage agent working through 20 real bug reports with screenshots from a public repository, and on a longer variant of the same job with 2.6 times the tokens. With caching on, input trimming (image resizing and tool search) took a further 26% off the short run and 21% off the long one.
#### Defer unused tool definitions
Every tool definition attached to a request is input on every turn, and a few MCP servers add up to hundreds of them. Anthropic ran the triage agent with its own two tools plus a catalog of real tool definitions from public MCP servers, for a total of up to 502 tools, loading all of them or marking the extras `defer_loading` behind [tool search](/docs/en/agents-and-tools/tool-use/tool-search-tool):
With every definition loaded, the run cost nearly doubled as the catalog grew, tracking the schema tokens on each request. With tool search it stayed flat at every catalog size, 45% less at 502 tools. Accuracy was 15 to 18 of 20 in every cell either way, and the model never called a wrong tool, so at this scale the catalog costs money, not correctness. The same holds for tools that come through the [MCP connector](/docs/en/agents-and-tools/mcp-connector): with a public GitHub MCP server attached, deferring its toolset (`default_config: {defer_loading: true}`) cut the run 20% at the same accuracy.
#### Keep data files out of the prompt
When the model has to compute over a table, upload it with the [Files API](/docs/en/build-with-claude/files) and let the model query it with [code execution](/docs/en/agents-and-tools/tool-use/code-execution-tool) instead of pasting it in. Anthropic asked 25 aggregate questions^([15](#refs)) (sums, filtered counts, group-bys, and a date filter) over a 1,862-row public CSV, with the answers computed by pandas:
Pasted into the prompt, the table is about 91,000 input tokens on every request, and Claude Sonnet 5 answered 6 of 25 questions correctly. Uploaded, with code execution, it answered all 25, and the run cost about a twelfth as much. Claude Opus 5 showed the same pattern.
#### Manage the context lifecycle
The context levers only pay on a session long enough to need them:
On the 20-issue run they saved nothing, and context editing cost 74% more. On the long run the prune saved 39% and compaction 32%, while context editing changed nothing. The prune is a few lines you write yourself: at each task boundary, replace large stale tool results with a one-line extract. It caches well because the edits sit at the tail of the conversation, where the next task adds new content anyway: 89% cache reads on the first request after a boundary and 81% on the requests between boundaries. Run-wide, the prune and context editing cache about equally well. The prune is cheaper because context editing rewrites content mid-task that the prune deletes (about two thirds of the gap) and because it keeps the context about half the size (the other third). If you use context editing, [clear in a few large batches](/docs/en/build-with-claude/context-editing#context-editing-and-prompt-caching). The prune, adapted from the harness:
```python
import re
PRUNED = "[pruned at issue boundary]"
def prune_task_boundary(messages, tool_name_by_id, threshold=2000):
"""Call once per task boundary. Replaces large, stale search results with a one-line extract."""
for message in messages:
if message["role"] != "user" or not isinstance(message["content"], list):
continue
for block in message["content"]:
if not (isinstance(block, dict) and block.get("type") == "tool_result"):
continue
if tool_name_by_id.get(block.get("tool_use_id")) != "search_issues":
continue
result_text = block.get("content")
if not isinstance(result_text, str) or len(result_text) <= threshold:
continue
if result_text.startswith(PRUNED):
continue # already pruned on an earlier boundary
# cap single-line results so the extract stays short
first_line = result_text.split("\n", 1)[0].strip()[:200]
refs = re.findall(r"#(\d+)", result_text)[:5]
extract = f"{PRUNED} {first_line}"
if refs:
extract += " kept refs: " + " ".join("#" + r for r in refs)
block["content"] = extract
```
### Batch work that can wait
The [Batch API](/docs/en/build-with-claude/batch-processing) takes 50% off every token of a request, including cached ones, in exchange for results arriving any time within 24 hours. Route every request no one is waiting on through a batch, and keep the interactive path for the rest. Batching is the second-largest free lever after caching for unattended agent work: evaluation runs, backfills, and scheduled jobs such as a recurring run of the issue-triage agent from the [token-trimming measurement](#trim-input-and-context-tokens). It combines with everything on this page except interactivity, but is not available for Claude Managed Agents sessions, which are interactive by design (see [Claude Managed Agents pricing](/docs/en/about-claude/pricing#claude-managed-agents-pricing)).
### Audit prompts against the current model
Each model generation responds to prompts differently, so a prompt accumulates text written for a model you no longer use. The usual case is over-specific instruction added to compensate for an older model: "verify twice," "be maximally thorough," a mandatory step-by-step procedure, or a hand-rolled reasoning scratchpad. A newer model follows these to the letter, producing extra tool rounds and extra writing, so the bill goes up with no gain in accuracy. Auditing prompts against the model you run now, and again whenever you change models, is a free win.
The audit is one command. The [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill) that ships with Claude Code has a `prompt-audit` command that reads a project's prompts and request code and reports what was written for a different model. This shortened excerpt shows it run against a support-desk prompt and request code containing those patterns:
```python
$ claude
> /claude-api prompt-audit
10 findings. The three that matter most:
1. budget_tokens returns a 400 on Opus 5 (support_agent.py:10). This code
does not run against its own target model. Everything else here is
quality; this one is an outage.
2. The prompt contains two live contradictions. Line 15 says confirm before
every refund, line 17 says process every eligible refund immediately.
Line 19 asks for a complete recap *and* a three-sentence maximum.
3. The reasoning scaffold and the 6-step script fight the model rather than
steer it. + "reason step by step" is now a request
parameter, not prose; the mandatory 6-step procedure plus "investigate
fully even when the ticket looks simple" forces four tool calls on a
"where's my package" ticket.
...
-After any refund or escalation, verify twice before submitting: re-fetch
-the order, re-check every figure in your reply against the fresh lookup,
-and review the reply a second time for errors.
+Before submitting a refund or an escalation, re-fetch the order and confirm
+every figure in your reply matches the fresh lookup.
```
The command then proposes its edits as a diff (one hunk shown) and lists what it deliberately left alone: the refund window, the tone requirement, and the quality bar. You review a patch, not a rewrite.
The effect is measurable. On a support-desk evaluation^([14](#refs)), prompts written for Claude Opus 4.8 cost 36% more per ticket on Claude Opus 5 for no change in accuracy. Running the audit over the same prompts made Opus 5 both cheaper than the unaudited version (by 14%) and more accurate (97% of tickets, up from 92%, a gain outside the noise). On the Claude Sonnet 4.6 to Claude Sonnet 5 migration, the audit took 14% off at the same accuracy:
The two kinds of stale text have different costs. Instructions the new model follows too literally cost money: removing "verify twice" cut Opus 5's cost per ticket by a third, and removing "be maximally thorough" almost as much. Text that no longer fits the model costs accuracy instead: a retired thinking setting, contradictory rules, and a hand-rolled scratchpad that conflicts with the model's own thinking each restored 7 to 11 points on Opus 5 when removed:
The same patterns tend to appear in tool descriptions and skills, which are worth auditing too.
## Trade cost against intelligence
These levers set where a single model sits between cost and intelligence: model choice, effort, re-running failures at a higher setting, the budgets and caps it works within, and whether it can see how much time has passed. Start with an effort sweep on your current model ([Tune effort](#tune-effort)). From lowest to highest cost and capability, the current models are Claude Haiku 4.5, Claude Sonnet 5, Claude Opus 5.5, and Claude Fable 5.1 (the frontier model); [Models overview](/docs/en/models/overview) has the full lineup and prices.
### Compare models on cost per task
Price lists are written per token, and per token the frontier model looks expensive: Claude Fable 5.1's per-token price is several times Claude Sonnet 5's. You pay for completed tasks, though, so compare models on cost per completed task. A more capable model finishes a task with less work: fewer turns, less searching, less re-reading of its own context, and less backtracking. The per-token premium is often overwhelmed by doing less of everything.
Anthropic measured this on the SWE-bench Pro^([3](#refs)) subset, priced as a customer is billed:
Claude Fable 5.1 at `low` effort solved 88.6% of tasks for \$0.54 per solved task, against 77.4% for \$0.84 from Claude Sonnet 5 at its default: 11 more points for 35% less per solved task, despite a per-token price five times higher. It does not always win, though. On the same subset, which Claude Opus 5.5 and Claude Fable 5.1 both largely saturate and whose scores are not comparable to the public leaderboard, Opus 5.5 at its default, `medium`, matched Fable 5.1 at its default (92.8% against 92.3%, inside run-to-run noise) for about a fifth of the cost per solved task (\$0.22 against \$1.19). At `low`, Opus 5.5 solved 87.4% for \$0.12. These figures use the 478 problems described in reference 3. And on long research loops the frontier model does more work, not less: on DeepResearch Bench II^([7](#refs)), Fable 5.1 at `low` scored 10 points above Sonnet 5 (66% against 56%) at about four times the cost per task (\$4.66 against \$1.20), because it runs a longer research loop over a larger context. Claude Opus 5 at its default scored 71% on the same basis for \$6.71 per task, above Fable 5.1 at its default (65% for \$7.12), so on research too Fable 5.1 earns its price only at `low`.
For most agent workloads, start with Claude Opus 5.5 at its default effort (`medium`), and use Claude Fable 5.1 for demanding reasoning and long-horizon agentic work, or when your evals on Claude Opus 5.5 at higher effort still fall short. On the SWE-bench Pro subset, Opus 5.5 at its default matched Fable 5.1 at its default for about a fifth of the cost per solved task, as noted earlier. On the coding benchmark in [Advisor strategy](#advisor-strategy-escalate-hard-decisions), it scored 86.6% against 84.2% for Fable 5.1 at `medium` (a single Fable 5.1 run), for under a third of the cost per attempt (\$0.84 against \$2.68). On Chartography^([13](#refs)), a chart-reading benchmark, Opus 5.5 at `low` scored 68.7 for about \$0.03 a chart, against 62.5 for \$0.15 from Fable 5.1 at `low` and 49 for \$0.16 from Claude Opus 5 at `low`. At the other end, Claude Haiku 4.5 answered GPQA Diamond^([9](#refs)) questions at about a fifth of Claude Opus 5.5's cost per question, with 63% accuracy compared with 92% for Opus 5.5, and fell much further behind on long coding tasks. It fits high-volume work with checkable outputs, not long agentic loops.
The ranking flips by workload, and no price list tells you which way. Price every candidate in cost per completed task on your own traffic, including Claude Opus 5.5 at its default effort and the frontier model at reduced effort.
Price the tail of your workload, not the median: compare models on the hardest tenth of your tasks, not the typical one. On the typical task every model looks similar and the cheapest looks best, but the bill is decided by the tasks the cheaper model fails, because a failed task still bills its tokens, then the retry, then whatever the failure costs downstream. The tail is also where the money goes even when nothing fails. On a 20-problem WideSearch^([1](#refs)) run, two problems carried 43% of the spend:
The [multi-model strategies](#combine-models) exist to spend frontier intelligence on that tail without paying frontier rates for the rest.
### Upgrade the model
If you are a model or two behind, the cheapest lever is the model string. Anthropic ran recent Claude Opus, Claude Sonnet, and Claude Fable models through the same harness on the SWE-bench Pro^([3](#refs)) subset, each at its shipped defaults and priced at list rates, and ran the Opus line again on Terminal-Bench 3^([20](#refs)):
Anthropic prices Claude Opus 4.7, Opus 4.8, and Opus 5 identically per token, so any difference among them comes from how much work each model does per task: priced as a customer is billed, Claude Opus 4.8 solves the same share of tasks as Claude Opus 4.7 for 14% less per solved task, and Claude Opus 5 then solves 12 more points of tasks at 21% more per solved task. Claude Opus 5 at `low` effort beats Opus 4.8's default on this benchmark for about 30% of its cost per solved task, so the cheapest upgrade is the new model at a lower setting. Sonnet 5's saving comes from its lower per-token price, which more than offsets the extra tokens it uses per task compared with Sonnet 4.6: 15% less per solved task for 5 more points. The frontier tier gained the same way: Claude Fable 5.1 matches Claude Fable 5's score for 43% less per solved task, most of it the lower cache-read price. That direction is not guaranteed: on DeepResearch Bench II^([7](#refs)) the same upgrade costs 41% more per task at `high` (79% more at `low`) for its 2 to 3 extra points on the tasks clean in every arm (reference 7), because the new model does more work per task there. The input and output prices are the same and the cache read is 4x cheaper, so measure the upgrade on your own workload before assuming it saves.
On harder work the gap widens. On Terminal-Bench 3^([20](#refs)), where the tasks are hard enough that pass rate rather than tokens sets the bill, Claude Opus 4.7, Opus 4.8, and Opus 5 each spend \$8 to \$15 per task but solve 7%, 15%, and 41% of tasks, so cost per solved task falls from \$183 to \$63 to \$28 up the ladder. The 21% premium Claude Opus 5 carries over Opus 4.8 on the saturated coding subset becomes a 56% saving on Terminal-Bench 3, where the older model mostly fails: the more your workload defeats the old model, the more the upgrade saves per result.
Compare on cost per solved task, not per token: the same text costs about 30% more tokens on Claude Opus 4.7 and later, so a per-token comparison makes the newer models look more expensive by construction.
### Tune effort
Effort is the most direct way to tune a model to your task. The `effort` parameter governs how much thinking, tool calling, and self-verification the model does, and `high`, the default on most models, suits demanding tasks; Claude Opus 5.5 defaults to `medium`. Cost scales with all that activity; accuracy scales only with the part your task needs. Below the model's ceiling, the highest effort levels pay for depth the task never uses.
On the research and knowledge-work benchmarks (WideSearch^([1](#refs)), DeepWideSearch^([6](#refs)), BrowseComp^([4](#refs)), and GDPval^([2](#refs)), all with Claude Fable 5), the curve of accuracy against cost is nearly flat: `low` gave up 1 to 3 points for a third to a half off the cost per task, `medium` matched the default's accuracy at about 70% to 87% of its cost, and the default bought nothing measurable over `medium` on any of the four. On DeepWideSearch, `low` also matched an orchestrator with a Claude Sonnet 5 worker at 29% lower cost: lowering effort beat an architecture change.
Lower effort settings are often faster, which matters when latency is the constraint. In these runs, `low` took 4.5 minutes per problem on DeepWideSearch, compared with 7.9 minutes at the default. On the [corpus benchmark](#orchestrator-strategy-delegate-bulk-work), whose input does not fit in any single context window, Fable 5.1 took 15.2, 17.5, and 19.9 hours per episode at `low`, `medium`, and `high`.
Long-horizon coding is where effort genuinely buys accuracy. On SWE-bench Pro^([3](#refs)), measured against `high`, Claude Opus 5.5 scored about 2.5 points lower at its default, `medium`, for about 70% of the cost, and about 8 points lower at `low` for about a third of the cost; `xhigh` scored about 1.4 points higher for 2.5 times the cost of `high`: a real tradeoff, which [re-running failures at higher effort](#re-run-failures-at-higher-effort) turns back into a saving. This chart plots accuracy against cost for the research and knowledge-work benchmarks and for SWE-bench Pro:
Two consequences follow. First, draw this curve for your own workload before you add a second model: in these internal measurements, a multi-model configuration that looked cheaper than the default single model cost more than that same model at lower effort. Second, this curve is the single-model baseline any multi-model strategy must beat, so [step 2 of measuring on your own workload](#measure-on-your-own-workload) baselines across effort levels.
Hard work does not automatically need high effort. On DeepResearch Bench II^([7](#refs)), Claude Fable 5.1 scored nearly the same at `low`, `medium`, and `high` while the cost per task rose from \$4.66 to \$7.12, so raising the effort in this case does not increase the quality of the output noticeably; on the 21 tasks clean in every arm (reference 7), Claude Fable 5 was flat across effort too, though the chart's 33-task basis, which drops each model's own cut-short attempts, shows it climbing. Measure the curve on the model you ship, not the one you measured last:
The task description alone does not reveal which kind of workload you have, so sweep two or three effort levels on a sample of your own traffic and read the answer off the curve. Test each level in a separate session: changing top-level effort mid-session invalidates the cache (see [Cache repeated context](#cache-repeated-context)) and distorts the comparison. For parameter details, see [Effort](/docs/en/build-with-claude/effort).
### Re-run failures at higher effort
When a task's outcome is checkable, the cheapest policy on the effort curve is not a fixed setting: run every task at a low setting and re-run only the failures at a higher one.
Anthropic computed this policy task by task from the effort runs on the SWE-bench Pro^([3](#refs)) subset in [Tune effort](#tune-effort). With Claude Opus 5.5 at `low`, 13% of tasks failed; with those re-run at `high`, about 97% passed for about \$0.17 each, against 95.3% for \$0.29 running everything at `high`: a slightly higher pass rate for a little over half the cost, counting the failed cheap attempts. Starting at `medium` instead solved about 97% for about \$0.24. Most of the small lift is the second attempt (re-running the failures of one `high` run at `high` scores about the same, for more money), so use this policy for the saving, not the lift:
Two conditions apply. First, you need a failure signal (here, the benchmark's own tests); a checker that passes bad work lets those failures through. Second, every first-pass failure takes two runs' worth of wall-clock time, so the saving is paid for in latency on the failures.
### Set budgets and output caps
Most agentic task runs are cheap, but a minority spend many times the median cost on searching, re-verifying, and over-testing. A [task budget](/docs/en/build-with-claude/task-budgets) targets that tail. The model sees a live token countdown for the whole task and self-regulates, trimming low-value searches, skipping redundant verification, and wrapping up instead of spiraling.
Anthropic measured pass rate and cost per task on SWE-bench Pro^([3](#refs)) with Claude Fable 5.1 as the budget tightened:
A generous budget cut cost per task 44% for about 3 points of pass rate, at the edge of run-to-run noise, and the tightest allowed budget cut it 58% for 6 points. Budgets bought efficiency here, at a price in pass rate that grows as the budget tightens.
Three controls do three different jobs. A task budget saves money, because the model sees it. `max_tokens` is a safety cap: lowering it cut cost per attempt without lowering cost per solved task. On Claude Managed Agents, a session budget is the hard dollar stop behind both. Set all three: a task budget, a high `max_tokens`, and a session cap for the run you never want on a bill, with a [workspace spend limit](/docs/en/api/rate-limits#setting-lower-limits-for-workspaces) as the final backstop.
- **Task budgets** are in beta (beta header `task-budgets-2026-03-13`) on the most recent models; check the [support table](/docs/en/build-with-claude/task-budgets#feature-support) for which. Start near your loop's 90th-percentile token usage, then tighten ([Choosing a budget](/docs/en/build-with-claude/task-budgets#choosing-a-budget) shows how to collect that distribution). Budgets below the current 20,000-token floor are rejected, and very tight budgets can produce refusal-like behavior. Set the budget once, on the first request, because a mid-task change [invalidates the cache](#cache-repeated-context). The budget is advisory, steering the model rather than stopping it, so verify adherence on your workload.
- **`max_tokens`** caps a single response, invisibly to the model, so lowering it does not make the model economize. The turns that needed the room are discarded and still billed. On an internal repository-task benchmark^([12](#refs)), a 16,384-token cap ended about a quarter of Claude Opus 5.5's attempts and 43% of Claude Fable 5.1's, each at its default effort. Only 1 of the 66 capped Opus 5.5 attempts and 9 of the 117 capped Fable attempts still passed. Capped runs spent less per attempt but bought proportionally fewer solves, so cost per solved task was about the same as at 64,000 (on Fable 5.1, \$21 against \$22; on Opus 5.5, within 1%). At 64,000, 2 of about 14,000 Claude Fable 5.1 turns at its default effort were still cut off (no Claude Opus 5.5 turn was), and Fable 5.1 solved 58.5% of tasks instead of 36.3% (on a separate cut of the SWE-bench Pro^([3](#refs)) subset, described in reference 12, no difference: 94 of 100 at either cap). Retrying capped attempts rarely helps: at the same cap most of them fail again, and at a higher one you also pay for the wasted attempt. Set `max_tokens` to 64,000 for agentic work, or to 128,000, the maximum, when a single cut-off attempt is costly; at 128,000 Fable 5.1 solved 60.0% for the same cost per solved task. [Stream responses](/docs/en/build-with-claude/streaming) that large, treat [`stop_reason: max_tokens`](/docs/en/build-with-claude/handling-stop-reasons#max-tokens) as a failure, and save money with effort and task budgets, which the model can see.
- **Session budgets on Claude Managed Agents** are the hard stop. A [session budget](/docs/en/managed-agents/budgets) is a dollar cap on one session at list rates for tokens, searches, and session time. At the cap, the session pauses with `stop_reason: budget_reached`; raising the budget resumes it. It is platform-enforced, works on any model with a list price, including models where task budgets are not yet available, and combines with the advisory task budget. Deployments apply the same field to every run.
Ask for shorter answers. Output tokens cost five times input tokens on Claude Sonnet 5, and in an agent loop every token the model writes comes back as input on every later turn, so you pay for a long answer again and again. Anthropic ran the triage job under three final-answer instructions, three runs each, with the same model and tools. The original asked for two lines:
```python
4. Finish with exactly two lines:
LABEL:
SUMMARY:
```
The shorter variant asked for one:
```python
4. Finish with exactly one line in this form:
DECISION | LABEL | REASON
where DECISION is one of: triage-now, needs-info, close-duplicate; LABEL is one of: bug-confirmed, needs-more-info, duplicate-candidate, feature-request, upstream-issue, perf, ui-polish; REASON is one clause under 15 words. Output nothing after that line.
```
The longer variant asked for a memo with five headed sections: problem summary, evidence, duplicate check, recommended label, and next steps. For one issue, a queued prompt that never sends after a skipped question, the first two answers were:
```python
LABEL: bug-confirmed
SUMMARY: When a user submits a new prompt instead of answering an agent's pending question, the question is cancelled/skipped but the new prompt remains stuck in "QUEUED" state indefinitely since it's waiting on a response to the now-cancelled question; the queued prompt should be processed immediately after cancellation.
```
```python
triage-now | bug-confirmed | Clear repro steps show prompt queues indefinitely after cancelled question.
```
The one-line answer used 39% fewer output tokens than the two-line original and cost 14% less per run. The memo used six times the output tokens and cost 2.8 times the one-line answer. All three scored within run-to-run noise of each other against the gold labels, so the formats differ in what you pay far more than in what they get right. Ask for the answer you will read, not the one that looks thorough.
At the lower `max_tokens` cap both models spend less per attempt but solve proportionally fewer tasks, so cost per solved task barely moves:
Almost every turn finishes far below either cap. The rare long turn is what the higher cap buys:
### Show the model elapsed time
A model in an agent loop can't see a clock. A [task budget](/docs/en/build-with-claude/task-budgets) shows it how many tokens are left, but by default nothing in the request shows it how long the work has taken. Two small changes give it that signal. Add a two-sentence instruction to the system prompt that says time matters, and from the second request on, send the elapsed time before each of the model's turns.
Anthropic measured both changes together with Claude Fable 5.1 at `high` effort, on two public benchmarks, DRACO^([21](#refs)) and HLE^([22](#refs)), and on an internal set of 70 research-level physics problems, adapted from the public CritPt benchmark^([23](#refs)). This page calls that set the physics set. Each of the three ran in two shapes: a single agent, and a team in which a lead agent starts helper agents of the same model that work in parallel. A score change counts as inside the margin when its 95% interval stays within a limit that Anthropic set before the runs: 1.5 points on DRACO and 2.5 points on HLE. The following chart plots score against cost per task for each configuration. A second row of bars gives each configuration's time as a ratio to the single agent at `high` effort, without retry waits. A third row gives the score change that both changes make, with its 95% interval:
**With a team of agents.** A team does more work than a single agent, so by default it costs more. On DRACO, the team cost 4.0 times as much as the single agent and took about as long (95% interval 12% less to 13% more). With the instruction and the clock on every agent, the team finished in 33% less time at a 54% lower cost per task. Its score was 1.5 points lower (95% interval 0.9 to 2.1 lower), and the far end of that interval, 2.1 points lower, is past the 1.5-point margin. On HLE, the team finished in 51% less time at a 54% lower cost per task. Its score was 1.7 points lower (95% interval 0.3 to 3.1 lower), and the far end of that interval, 3.1 points lower, is past the 2.5-point margin. On the physics set^([23](#refs)), the team finished in 39% less time. Its cost per task was 28% lower, and that saving depends on how often the prompt cache expired between requests. With no expiry, it would be 23%. Its score was 0.2 points higher (95% interval 1.5 lower to 2.0 higher).
On DRACO, the lead started a median of 4 helpers per attempt, so the DRACO result shows a team working in parallel. On HLE and the physics set, the lead started a median of 0 helpers, so at least half of those team runs had only the lead agent. Those team results mostly show the lead agent's own behavior, not the effect of parallel helpers.
**With a single agent.** On the physics set^([23](#refs)), the same changes cut a single agent's time by 34% and its cost per task by 34%. Its score was 0.2 points lower (95% interval 2.5 lower to 2.1 higher). On the physics set, a lower effort level saved cost but not clearly time. At `medium` effort, the single agent cost 37% less per task than at `high`, and its time was 9% less (95% interval 30% less to 16% more). It scored 3.4 points lower (95% interval 0.4 to 6.8 lower), and the interval reaches close to zero. With both changes at `high` effort, the single agent took 27% less time than at `medium` effort (95% interval 5% less to 44% less). Its cost per task was 6% more (95% interval 12% less to 27% more), and its score was 3.2 points higher (95% interval 0.1 lower to 6.5 higher).
On HLE, the same changes cut a single agent's time by 54% and its cost per task by 48%. Its score was 1.1 points lower (95% interval 2.6 lower to 0.3 higher), and the far end of that interval, 2.6 points lower, is just past the 2.5-point margin. At `medium` effort, the single agent cost 43% less per task than at `high`, took 39% less time, and scored 1.3 points lower (95% interval 2.8 lower to 0.1 higher). With both changes at `high` effort, the single agent took 25% less time than at `medium` effort (95% interval 12% less to 35% less). Its cost per task was 9% less (95% interval 21% less to 6% more), and its score was 0.2 points higher (95% interval 1.3 lower to 1.7 higher).
On DRACO, the same changes cut a single agent's time by 69% and its cost per task by 49%. Its score was 1.9 points lower (95% interval 1.1 to 2.8 lower), and the far end of that interval, 2.8 points lower, is past the 1.5-point margin. At `medium` effort, the single agent cost 25% less per task than at `high`, took 30% less time, and scored 0.7 points lower (95% interval 0.1 to 1.3 lower). With both changes at `high` effort, the single agent took 53% less time than at `medium` effort (95% interval 42% less to 63% less), and its cost per task was 31% less (95% interval 28% less to 35% less). Its score was 1.2 points lower (95% interval 0.5 to 1.9 lower), and the far end of that interval, 1.9 points lower, is past the 1.5-point margin.
On all three sets, both changes at `high` effort saved more time than `medium` effort did. On HLE and the physics set, there was no clear difference in cost, and on DRACO the cost was lower. The score was about the same on HLE. On the physics set it was 3.2 points higher, but that interval includes zero, so the difference isn't clear. So for a single agent, the clock saves more time than a lower effort level does. On DRACO, though, the single agent with both changes scored 1.2 points lower than at `medium` effort (95% interval 0.5 to 1.9 lower).
**When to use it.**
- Use both changes when an agent's time matters and a small score change is acceptable. On every configuration measured, they cut the time and cost per task, for teams and for single agents.
- Check score on your own tasks before you adopt them. On DRACO, the score was 1.5 points lower for a team and 1.9 points lower for a single agent. On HLE, it was 1.7 points lower for a team and 1.1 points lower for a single agent. On the physics set, neither score change was clearly different from zero.
- If you're already thinking about a lower effort level to save time, compare it with the clock. A single agent with both changes at `high` effort took less time than at `medium` effort: 53% less on DRACO, 25% less on HLE, and 27% less on the physics set. Its cost per task was 31% lower on DRACO, with no clear difference on HLE and the physics set.
**How to add it.** Put this instruction at the start of every agent's system prompt:
``` block
Time matters here: do not spend time that can be avoided, and the earlier a correct result is obtained, the better. The elapsed time so far is shown before each of your turns.
```
The second sentence tells the model that the clock messages exist. The first request carries no clock, and the measured runs used exactly this wording.
Then, before each request after an agent's first, append a [mid-conversation system message](/docs/en/build-with-claude/mid-conversation-system-messages) that gives the elapsed time in whole seconds, such as `Elapsed time: 412 seconds`. Count from the start of the task, not from the start of the agent. In a team, every agent reads the same clock, so the first clock a helper sees already counts the time the team spent before the helper started. In a tool loop, put the message right after the `user` message that carries the tool results, as [Placement after tool results](/docs/en/build-with-claude/mid-conversation-system-messages#placement-after-tool-results) shows. If you send the agent a new `user` message instead, put the clock after that message.
Leave earlier clock messages where they are. Each one becomes part of the conversation history, so the cached prefix still matches on the next request (see [Combining with prompt caching](/docs/en/build-with-claude/mid-conversation-system-messages#combining-with-prompt-caching)). Anthropic measured these plain system messages, which stay visible to the model. A [turn-scoped system message](/docs/en/build-with-claude/mid-conversation-system-messages#turn-scoped-system-messages) would show the model only the newest clock, and Anthropic didn't measure that form.
The following example runs one agent's tool loop with both changes. It adds the clock after tool results, and it handles client tools only:
```python
import time
import anthropic
client = anthropic.Anthropic()
TIME_MATTERS = (
"Time matters here: do not spend time that can be avoided, and the earlier a "
"correct result is obtained, the better. The elapsed time so far is shown before "
"each of your turns."
)
def run_agent(task, system, tools, run_tool, started_at=None):
"""Run one agent's tool loop. In a team, pass the lead's started_at to every helper."""
if started_at is None:
# Wall-clock seconds, so helpers in other processes can share the lead's start time.
started_at = time.time()
messages = [{"role": "user", "content": task}]
while True:
# Stream because a 128,000-token cap is too large for a non-streaming request.
with client.messages.stream(
model="claude-fable-5-1",
max_tokens=128000,
cache_control={"type": "ephemeral"},
system=TIME_MATTERS + "\n\n" + system,
tools=tools,
messages=messages,
) as stream:
response = stream.get_final_message()
messages.append({"role": "assistant", "content": response.content})
if response.stop_reason != "tool_use":
return response
results = [
{
"type": "tool_result",
"tool_use_id": block.id,
"content": run_tool(block.name, block.input),
}
for block in response.content
if block.type == "tool_use"
]
messages.append({"role": "user", "content": results})
# A system message must follow a user turn, so the clock goes after the tool results.
elapsed = int(time.time() - started_at)
messages.append(
{"role": "system", "content": f"Elapsed time: {elapsed} seconds"}
)
```
Claude Fable 5.1 supports mid-conversation system messages. The [list of supported models](/docs/en/build-with-claude/mid-conversation-system-messages) covers the others. On a model without them, such as Claude Sonnet 5, you can put the same line in a text block after the last `tool_result` block in the `user` turn. Anthropic measured only the system-message form.
On Claude Managed Agents, you can send a [`system.message` event](/docs/en/managed-agents/events-and-streaming#sending-system-messages) with a tool result or a user message. The message applies to that turn and every later turn. So turns that follow the platform's built-in tools, such as web search, see the last clock you sent, not the current time. A `system.message` also reaches only the session's primary thread. In a [multiagent session](/docs/en/managed-agents/multiagent-orchestration), that is the coordinator's thread, so the worker agents never see a clock that you send this way. To show the current time before every turn, and to every agent in a team, run the agent loop yourself on the Messages API.
## Combine models
Multi-model architectures fit workloads whose task complexity varies enough that different steps are best served by different models. When your traffic mixes routine work that a smaller model handles reliably with harder steps that need frontier capability, splitting the work keeps frontier intelligence where it matters while most tokens bill at smaller-model rates. When a workload lacks that mix, because its difficulty is uniform or it is one dependent chain, a single well-tuned model is usually the better choice. Each strategy section gives the rule for telling the two cases apart.
Two strategies cover most workloads, and they differ in which model holds the main loop:
| Strategy | Control flow | Frontier model's role | Fits | Frontier cost scales with |
|:-----------------|:------------------------------------------------------|:------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|:--------------------------------------|
| **Advisor** | Smaller model runs the loop, escalates on demand | Consulted for plans and corrections | Serial work that is hard in spots, such as a coding agent's many turns between a few real decisions | How often the executor gets stuck |
| **Orchestrator** | Frontier model runs the loop, delegates the bulk work | Plans, dispatches, and synthesizes | Work that fans out across genuinely independent files, documents, or cases, especially more than one context window of it | How hard the pieces are to coordinate |
### Advisor strategy: escalate hard decisions
In the advisor strategy, a lower-cost executor model runs the agent loop and performs most turns. When it hits a decision that needs deeper judgment, such as choosing an approach or recovering from a failure, it calls a higher-intelligence advisor model for strategic guidance, then continues. Most tokens are billed at executor rates, and only the occasional consultations at advisor rates.
To use it, add the [advisor tool](/docs/en/agents-and-tools/tool-use/advisor-tool) to your request. This beta feature runs the whole strategy server-side in one `/v1/messages` request: the executor emits a tool call, Anthropic runs the advisor inference, and the executor continues with the advice; you write no orchestration code. On Claude Managed Agents, [give the session an advisor](/docs/en/managed-agents/multiagent-orchestration#give-the-session-an-advisor) by adding an `advisor` entry to the agent's `multiagent` roster; the session's primary thread consults it the same way. Claude Code supports it too; see [escalating hard decisions with the advisor tool](https://code.claude.com/docs/en/advisor).
**What sets the payoff.** The advisor sees the task only through the executor's calls, so two things decide how much it helps.
The first is the gap between the models. The advisor can only hand over capability the executor lacks: on GPQA Diamond^([9](#refs)) a Claude Haiku 4.5 executor gained a great deal from a Claude Opus 5 advisor, a Claude Sonnet 5 executor gained a few points, and a frontier executor almost nothing.
The second, and the fragile one, is whether the executor actually asks (the consult rate). An executor at low effort can stop detecting that it is stuck: a pairing that consults on most tasks at the default effort can fall to consulting on almost none when effort is lowered, and then scores below the executor alone. The rate also varies by task: on DeepSWE^([10](#refs)) a low-effort Sonnet 5 executor kept asking and gained 23 points; on SWE-bench Pro^([3](#refs)) the same executor stopped. When the executor does ask, it recovers much of the gap. Across the pairings in the following chart whose executor kept asking, the advisor closed at least half the gap to the stronger model (the coding pairing beat the stronger model outright), and you pay for the stronger model only on the consultations, which is what makes the cost cases possible:
The consult rate responds to prompting. With only the tool's built-in description, executors under-call, especially on coding work, so the [advisor tool documentation](/docs/en/agents-and-tools/tool-use/advisor-tool#prompting-for-coding-and-agent-tasks) gives a system prompt that asks for one call before substantive work and one before finishing, about two to three calls per task. The coding pairing measured next ran at that cadence with Claude Opus 5 as the executor, about two consultations on every task; with Claude Opus 5.5 as the executor it asked for advice about 1.4 times per attempt, and 4% of its attempts received no advice. That page also covers nudging an under-calling executor and capping calls client-side to bound cost. So watch the consult rate: prompt for it, measure it, and restore the executor's effort if it collapses.
**When it pays on cost.** An advisor saves money when a few short consultations, billed at the advisor's rate, replace running the advisor's model for the whole task. That works best when the advisor's model is priced well above the executor's, so the most cost-effective configuration is a frontier advisor over a mid-tier executor. A pairing at the top of the range can recover part of the advice's cost, because advice also saves executor tokens: an executor told the right approach explores fewer dead ends. In the coding pairing below with a Claude Opus 5 executor, that saving paid for about half of the advice: the executor spent \$1.26 less per attempt than Opus 5 alone at its default, and the consultations cost \$2.47. With a Claude Opus 5.5 executor, the advice saved almost no executor cost: \$1.36 per attempt against \$1.38 for Opus 5.5 alone at `high`, while the consultations cost \$1.55.
On an internal agentic-coding benchmark^([11](#refs)), run with a plain API agent, a Claude Opus 5.5 executor at `high` with a Claude Fable 5.1 advisor scored 90.1% at \$2.92 per attempt. That is 1.7 points over Opus 5.5 alone at `high`, the executor's own setting, a gap at the edge of run-to-run noise with five attempts per task, for about 2.1 times the money; against Opus 5.5 at its default, `medium`, it is 3.5 points for about 3.5 times the money. It lands about on Opus 5.5's own effort curve, so the advisor buys about what more effort does: Opus 5.5 alone at `xhigh` scored 91.1% for \$4.11 per attempt (one attempt per task). In August, a Claude Fable 5.1 advisor over a Claude Opus 5 executor was the most accurate configuration measured, at \$6.21 per attempt, a little over twice what the Opus 5.5 pairing costs. The chart plots the Opus 5.5 pairing against Opus 5.5's own effort curve and Claude Fable 5.1's from August:
An earlier measurement through [Claude Code's advisor mode](https://code.claude.com/docs/en/advisor) also ranked its advisor pairing above both of its models alone. Read the Claude Opus 5.5 result as a shape to test on your workload: the advisor buys a few points for about twice what the executor costs alone. A wider capability gap does not guarantee a better deal. The latency cost is the consultations themselves: about one or two extra frontier-model calls per task on this benchmark, each on the task's critical path.
**When the stronger model alone is the better step.** Where a workload's accuracy responds to effort, compare the pairing with the advisor's model alone at a reduced setting before building it: the advisor is paid for only on tasks that need it, but a consult that fires on most tasks costs more than running the stronger model itself. On Chartography^([13](#refs)), a Claude Opus 5.5 executor at `low`, given a Claude Fable 5.1 advisor, consulted it on 1 of 300 tasks and scored 61.7, 7 points below Opus 5.5 alone and beyond run-to-run noise, at about the same cost; in August, a Claude Opus 5 executor consulted on nearly every task, and that pairing matched Fable 5.1 alone at `medium` within run-to-run noise (65.0 against 67.5) at about 1.8 times the cost per task. Measure your own consult rate first: if the executor asks on most of its tasks, you are paying advisor rates across the whole workload, and running the advisor's model itself is the cheaper way to the same score.
Whatever the pairing, first price the advisor's model alone at low effort; that is the baseline to beat. Recheck at every model release, because releases move both the capability gap and the price ratio.
**When it fits.** The advisor strategy suits workloads where turns are mostly mechanical but an excellent plan matters: coding agents, computer use, and multistep research pipelines. It fits poorly when every turn genuinely needs frontier capability, when there is nothing to plan (single-turn Q&A), or when your executor is already close to the advisor's capability.
### Orchestrator strategy: delegate bulk work
In the orchestrator strategy, the frontier model holds the loop. It decomposes the task, dispatches subtasks to lower-cost worker models, and merges their results. The orchestrator's own transcript stays short because workers absorb the token-heavy exploration, so most tokens are billed at worker rates while the plan and synthesis still come from the frontier model.
To build one, use [multiagent orchestration](/docs/en/managed-agents/multiagent-orchestration) in Claude Managed Agents: configure a coordinator agent (the orchestrator) and a roster of worker agents, each with its own model. For a complete working example with a frontier coordinator and Claude Sonnet 5 workers, see the Claude Cookbook recipe [Coordinator pattern: big models for planning, small models for execution](https://github.com/anthropics/claude-cookbooks/blob/main/managed_agents/CMA_plan_big_execute_small.ipynb).
This pattern saves wall-clock time when workers can run in parallel: on the corpus benchmark^([8](#refs)), an episode took about 2.3 hours with the coordinator running the platform's documented limit of 25 concurrent workers, compared with 15 to 20 hours solo. It saved money in only two measured situations. On work a single model could handle alone, the same model at lower effort was cheaper every time.
When workers run in parallel, a time instruction and an elapsed-time clock can shorten the run. On DRACO^([21](#refs)), a team of same-model agents with the instruction and the clock finished in 33% less time at a 54% lower cost per task, and scored 1.5 points lower. Every agent in that team had the instruction and the clock. Anthropic didn't measure the clock with lower-cost workers. On Claude Managed Agents, the clock reaches only the coordinator, so the workers never see it. Anthropic didn't measure a team in which only the coordinator has the clock. The coordinator's clock is also current only on turns that follow your own tool results or messages. [Show the model elapsed time](#show-the-model-elapsed-time) has the recipe for an agent loop that you run on the Messages API.
**Case 1: insurance against the cost tail on routine work.** A frontier model running alone occasionally spirals on a routine problem it would normally solve. Because you cannot tell in advance which those will be, a few such runs dominate the bill. A coordinator that hands routine work to a lower-cost worker caps that tail, because any spiraling now happens at worker rates.
Anthropic measured this on a deliberately easy slice of BrowseComp^([4](#refs)) (10 problems the solo model reliably solves; 50 delegated and 70 solo runs). A Claude Fable 5 coordinator with one Claude Sonnet 5 worker cost about half as much as Claude Fable 5 alone on average and about a third as much at the 90th percentile (\$12 compared with \$33), and the solo model's single most expensive run, at \$84, was also wrong:
Delegation paid on the routine, normally solvable share of the work, the opposite of the intuition that workers are for hard problems. On the full, harder BrowseComp set, the economics reversed. If your traffic has a long cost tail on routine tasks, this is the orchestrator case to measure first.
**Case 2: work larger than one context window.** A solo model must work through an input that large serially, one context window at a time, paying to re-read its own state on every pass. Workers each read their own partition, in parallel and at worker rates. Reading-heavy work that still fits in one context window is a model-choice problem, not a delegation problem: on reading cost alone, the orchestrator comes out ahead only when no single context can hold the work.
Anthropic built a benchmark for this case^([8](#refs)): a 21.6-million-token corpus of 14 public Python packages with 130 planted defects, too large for any context window. Lowering effort cannot help, because the bill is the corpus read itself: Claude Fable 5.1 solo cost \$468 to \$552 per episode across the three effort settings, and only its accuracy moved. The coordinator configuration, a Claude Fable 5.1 lead over 25 Claude Sonnet 5 workers, cost about half as much as those settings (47% to 55% less) and scored 10 to 12 points below them, in about 2.3 hours per episode against 15 to 20, while beating a Claude Sonnet 5 solo baseline outright:
The token accounting shows the scale of the reading: the coordinator configuration read about 560 million cached tokens per episode, about one and a half times the solo model's roughly 365 million, nearly all of them at Claude Sonnet 5's cache-read rate, and still cost about half as much overall. Fable 5.1 at `high` effort still holds peak accuracy, at about 2.2 times the coordinator configuration's cost, so delegation here buys most of the accuracy, not all of it.
**When delegation doesn't pay.** An orchestrator buys something only when there is bulk to hand off: many independent pieces, ideally too many for one context window. When the work is one dependent chain, or fits in a single context, the orchestrator pays for a plan, a handoff, and a merge that a single model gets for free. In every such case measured, the coordinator's model alone at lower effort came out ahead.
The boundary is task difficulty, not the benchmark: on the full, harder BrowseComp^([4](#refs)) set, Claude Fable 5 alone reached the coordinator configuration's accuracy at 22% to 30% lower cost. Independent external work reports the same pattern^([5](#refs)). If the work is one chain, fits in one context without a long cost tail, or a single model at lower effort already meets your bar, don't build an orchestrator.
### Choose between the strategies
Most cases come down to one question: does the work split into independent pieces, or is it one answer reached through a chain of dependent steps? The [strategy table](#combine-models) maps the two answers to the two strategies.
If you are unsure, don't build anything yet:
1. Sweep effort on your current model first. It is the cheapest experiment on this page, and most workloads end there.
2. If the sweep shows a gap, price the stronger model alone at low effort. That is the number an advisor pairing has to beat, and the pairings on this page that beat it were the ones whose executor actually consulted.
The multi-model results on this page were judged against the same model at lower effort and against the next model down running alone. That is the comparison to run on your own workload, and why the first step is an effort sweep.
When you do add an advisor, it is a tool definition rather than a rearchitecture.
## Measure on your own workload
The numbers on this page reflect list prices at the time of measurement and will drift as models and prices change. Your escalation rate, how cleanly tasks split, and transcript length move them too. The method stays the same:
1. Pull a few tasks from production logs, weighted like real traffic, and [write outcome checks](/docs/en/test-and-evaluate/develop-tests) for each: tests pass, ticket closed, row count correct. Record cost per task beside the score: price the five priced token counts in each response's `usage` at their own rates (uncached input, 5-minute and 1-hour cache writes at 1.25x and 2x the input price, cache reads, and output), summed across the task's requests (the [Usage and Cost API](/docs/en/manage-claude/usage-cost-api) reports the aggregate).
2. Baseline the model tiers across effort levels, not only the default, and plot score against spend. A multi-model configuration must beat the single model's whole curve.
3. If the curve shows a gap effort can't close, add the multi-model strategy that fits and re-run the suite.
4. Run the winner in shadow on a traffic slice before cutover, then keep the suite running.
The following example computes one request's step 1 cost at Claude Opus 5.5's list prices:
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
# Per-million-token prices from the pricing page; change these three for another model.
INPUT_PER_MTOK = 4.00 # Claude Opus 5.5
# 0.05x the input price on Claude Opus 5.5; the multiplier differs by model
CACHE_READ_PER_MTOK = 0.20
OUTPUT_PER_MTOK = 20.00
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
)
usage = response.usage
cache_writes = usage.cache_creation
writes_1h = cache_writes.ephemeral_1h_input_tokens if cache_writes else 0
writes_5m = cache_writes.ephemeral_5m_input_tokens if cache_writes else 0
cost = (
usage.input_tokens * INPUT_PER_MTOK
# 1-hour cache writes bill at 2x the input price, 5-minute at 1.25x; reads at the cache-read price.
+ writes_1h * INPUT_PER_MTOK * 2.0
+ writes_5m * INPUT_PER_MTOK * 1.25
+ (usage.cache_read_input_tokens or 0) * CACHE_READ_PER_MTOK
+ usage.output_tokens * OUTPUT_PER_MTOK
) / 1_000_000
print(f"Request cost: ${cost:.6f}")
```
In agent loops most input tokens should be cache reads; if `cache_read_input_tokens` is small next to `input_tokens` plus `cache_creation_input_tokens`, check that caching is engaged and that the prefix stays the same between requests. When the [advisor tool](/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing) or [compaction](/docs/en/build-with-claude/compaction-threshold#understanding-usage) is enabled, some tokens are reported only in `usage.iterations` and not in the top-level totals, so sum over `usage.iterations` instead, pricing `advisor_message` entries at the advisor model's rates.
The following table lists the levers in the order to try them:
| Lever | Saving in these runs | Quality cost | Latency | Where |
|:--------------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------------------------|:--------------------------------------|:------------------------------------------------------------------------------------|
| Prompt caching | Cost cut by a factor of 2.7 to 5.3 on agent loops; 83% on the triage run | None | Faster | [Cache repeated context](#cache-repeated-context) |
| 1-hour cache duration | Cheaper than the 5-minute default once about 1 turn in 20 follows a pause between 5 minutes and an hour and few gaps run over an hour, except on Claude Fable 5.1, where keeping the 5-minute cache warm is cheaper while pauses run minutes and the 1-hour duration wins when pauses run toward an hour, and on Claude Opus 5.5, where keeping the 5-minute cache warm is cheaper when only a turn or two in 20 follow a pause of up to about half an hour; with no pauses the default cost 15% less on Claude Sonnet 5 and about 15% to 18% less on Claude Opus 5.5 | None | Stays warm after a pause | [Pick the cache duration](#pick-the-cache-duration) |
| Input trimming | A further 5 percentage points on the triage run | None | Neutral | [Trim input and context tokens](#trim-input-and-context-tokens) |
| Prune stale tool results at task boundaries | 39% on the long triage run (compaction 32%); nothing on short loops | None measured | Neutral | [Trim input and context tokens](#trim-input-and-context-tokens) |
| Tool search | 45% with 500 tool definitions attached; 20% with a GitHub MCP server | None | Neutral | [Trim input and context tokens](#trim-input-and-context-tokens) |
| Data files through code execution | 92% on a 25-question data task | A gain, 25 of 25 instead of 6 of 25 | Faster | [Trim input and context tokens](#trim-input-and-context-tokens) |
| Batch API | 50% | None | Results within 24 hours | [Batch work that can wait](#batch-work-that-can-wait) |
| Prompt audit against the current model | 14% on both migrations measured | None; a gain on one | Faster (fewer tool rounds) | [Audit prompts against the current model](#audit-prompts-against-the-current-model) |
| Upgrade the model | Opus 4.8 to Opus 5: 12 more points at 21% more per solved task (Opus 5 at `low` beats Opus 4.8 for about 30% of the cost); Sonnet 4.6 to Sonnet 5: 15% less per solved task, 5 more points; Fable 5 to Fable 5.1: 43% less per solved task at about the same score | A gain | Neutral | [Upgrade the model](#upgrade-the-model) |
| Lower effort | Knowledge work: `medium` 13% to 31%, `low` a third to a half; long coding: `medium` about 30% and `low` about two thirds, both against `high` | 1 to 3 points on knowledge work, 2 to 8 on long coding | Faster | [Tune effort](#tune-effort) |
| Re-run failures | About 40% against running everything at `high`, at the same pass rate or slightly better | None | Two runs on the tasks that fail | [Re-run failures at higher effort](#re-run-failures-at-higher-effort) |
| Task budget | 44% to 58% | 3 to 6 points | Faster | [Set budgets and output caps](#set-budgets-and-output-caps) |
| Ask for shorter answers | 39% of output tokens, 14% of cost on the triage run | None | Faster | [Set budgets and output caps](#set-budgets-and-output-caps) |
| Raising `max_tokens` | None per solved task, but more tasks solved | Gains of up to 22 points on the internal set; none on the public pair | Neutral | [Set budgets and output caps](#set-budgets-and-output-caps) |
| Advisor | Depends on the capability gap and the consult rate; the coding pairing scored 1.7 points over Claude Opus 5.5 alone at `high` for about 2.1 times the price, about what more effort buys; with Claude Opus 5.5, the chart-reading pairing almost never consulted the advisor and scored 7 points below Opus 5.5 alone | A gain on coding, a loss on chart reading | About one or two extra calls per task | [Advisor strategy](#advisor-strategy-escalate-hard-decisions) |
| Orchestrator | About half against the frontier model, both beyond one context window and on routine tails (the latter measured on Claude Fable 5) | 10 to 12 points below the frontier model | Much faster on large inputs | [Orchestrator strategy](#orchestrator-strategy-delegate-bulk-work) |
## Benchmarks referenced
Except where a reference says otherwise, measurements are Anthropic-internal runs of these benchmarks. Unless noted, costs are USD at the list prices in effect when each benchmark ran; Claude Sonnet 5 figures use \$2 and \$10 per million input and output tokens. Charts labeled "notional USD" price each request's token counts at those rates rather than reporting invoices.
1. **WideSearch:** Wong et al., "WideSearch: Benchmarking Agentic Broad Info-Seeking," arXiv:2508.07999, 2025. Broad web-research tasks graded on a many-row table's completeness and accuracy; 200 problems, 3 runs per configuration, run August 1 to 2, 2026. The cost-concentration chart is a separate 20-problem run, 3 runs per problem, run August 3 to 4, 2026, costed from per-request billing records.
2. **GDPval:** OpenAI, "GDPval: Evaluating AI Model Performance on Real-World Economically Valuable Tasks," 2025. Knowledge-work deliverables graded against task rubrics; a 210-task run of the released gold set, one attempt per task, run August 2, 2026. A Claude model grades, so absolute scores may differ from published results.
3. **SWE-bench Pro:** Scale AI, "SWE-Bench Pro: Can AI Agents Solve Long-Horizon Software Engineering Tasks?", 2025. A 482-problem subset selected for compatibility with Anthropic's evaluation harness; scores are not comparable to the public leaderboard. They are also not comparable to the SWE-bench Pro results in the Claude Opus 5.5 system card, which come from runs at `max` effort on a different problem set. Claude Opus 5.5 figures average two runs at `low`, `medium` (its default) and `high`, and use one run at `xhigh`, all run September 19 to 20, 2026, with the same 16,384-token cap per turn as the August Claude Opus 5 runs; the cap cut off 2 `xhigh` attempts and none at other settings. The Opus 5.5 runs used a version of the benchmark whose grading containers can reach only internal package mirrors. That version drops one problem whose test needs a live website, and on three more the reference solution fails there, so Opus 5.5 comparisons, and the Claude Fable 5.1 figures set beside them, use the remaining 478 problems. The Claude Opus 5 SWE-bench Pro figures in [Upgrade the model](#upgrade-the-model) and the [advisor pairings chart](#advisor-strategy-escalate-hard-decisions) average two runs at its default effort and use one run at `low`, all run August 4, 2026. Escalation figures come task by task from the Opus 5.5 runs: `low` first, then `high` on its failures, solved 96.4% to 97.5% across run pairings for about \$0.17; `medium` first, 96.0% to 97.1% for about \$0.24; `high` re-run on its own failures, 96.9% for \$0.31; everything at `high`, 94.8% to 95.8% for \$0.29. Costs on this subset are priced as a customer's organization is metered: each request's prior prompt as a cache read and its new tokens as a 5-minute cache write, from the runs' own usage records, checked against a customer ledger; the evaluation organization's own metering, which until September 10, 2026, billed cache reads in 8,192-token blocks for Claude Opus 5, Claude Fable 5, Claude Opus 4.7, and Claude Opus 4.8, gave figures 1.4 to 1.8 times higher for those models' runs; for Claude Fable 5.1, Claude Sonnet 5, and Claude Sonnet 4.6 the two differ by at most about 9%, and for the Claude Opus 5.5 figures they agree within 3% at each effort setting. The Claude Sonnet 5 executor pairings on the advisor chart come from the same measurement series on this subset: the Sonnet-plus-Opus 5 pairing was run twice (August 7 and August 8, 2026, a run and an exact replication), the low-effort pairing once (August 8, 2026), and Claude Sonnet 5 alone twice (77.4%, the baseline for both Pro rows). The Claude Fable 5 point in Upgrade the model is the mean of three runs at the default effort, run August 26, 2026, priced the same way. The Claude Fable 5.1 task-budget figures are one run per budget (two at 35,000 tokens) on the same subset at the default effort, run August 26, 2026, with an unbudgeted run the same day (92.1%, \$1.10 per task) as the baseline; an earlier set at `low` effort, run August 21, 2026, scored 88.6% unbudgeted at \$0.48 per task. The [Compare models](#compare-models-on-cost-per-task) comparison pairs that single run with the two pooled Claude Sonnet 5 runs from the same subset; at Fable 5.1's default effort the pair reads the other way, 41% more per solved task than Sonnet 5. The upgrade ladder is one run per model at its shipped defaults (two each for Opus 5 and Sonnet 5, and the Fable 5 point as described above), the Opus and Sonnet runs the same week in one harness and organization.
4. **BrowseComp:** Wei et al., "BrowseComp: A Simple Yet Challenging Benchmark for Browsing Agents," OpenAI, 2025. Effort figures use a 500-problem cut, one to three runs per setting, run August 3, 2026, with the default point pooling two runs from July 26 to 27, 2026. The cost-insurance chart uses 10 reliably solved problems from a 26-problem slice, 50 delegated runs (August 1 to 2, 2026) and 70 solo runs (50 from August 2 to 3, 2026; 20 archived from July 12 to 13 and August 1, 2026), \$6.45 compared with \$11.99 per run in expectation; delegated figures carry a measurement band of about 20%.
5. **Agent-architecture scaling:** Kim et al., "Towards a Science of Scaling Agent Systems," arXiv:2512.08296, 2025. Independent external study, cited only for the direction of the finding on when delegation does not pay, not for any figure.
6. **DeepWideSearch:** "DeepWideSearch: Benchmarking Depth and Width in Agentic Information Seeking," arXiv:2510.20168, 2025. The 220 questions span 15 domains, each combining many-row collection with multi-hop retrieval; measured on the benchmark's standing row set, 3 runs per configuration, run August 2, 2026 (the single-worker team point ran July 26 to 27, 2026).
7. **DeepResearch Bench II:** Li et al., "DeepResearch Bench II: Diagnosing Deep Research Agents via Rubrics from Expert Report," arXiv:2601.08536, 2026. Its 132 research tasks across 22 domains are graded against expert-derived binary rubrics; measured on a 50-task subset stratified across all themes, one attempt per task, 3 runs per setting, on [Claude Managed Agents](/docs/en/managed-agents/overview) with the platform's own web search and fetch tools (August 26 to 27, 2026); scored on the 33 tasks no configuration refused, with attempts the production safety classifiers cut short removed; costs are what a customer is billed, the platform's requests plus web-search fees. Scores are each model's mean on the 33-task basis with its own pre-empted tasks removed; on the 21 tasks clean in every arm, Claude Fable 5.1 holds a 2-to-3-point lead over Claude Fable 5 at every effort level and both models are flat across effort. The caching chart re-prices the same requests with every input token at the uncached rate. Claude Opus 4.6 judges under the benchmark's rubric protocol; the original uses a different judge, and an Anthropic judge may favor the house style. Claude Opus 5 at its default effort ran on the same surface and subset, three runs, on August 28, 2026: 68.8% on the raw 50 tasks, 70.8% on the 33-task basis, and 71.1% on the 21-task set, at \$6.71 per task (\$23.72 without caching); none of its attempts was cut short by the safety classifiers, under a safeguards deployment newer than the one the other models ran under.
8. **Corpus defect sweep:** Anthropic-internal, for work larger than one context window: a 21.6-million-token corpus from 14 public Python package sources with 130 planted defects and deterministic grading; protocol fixed before the runs and internally reviewed; three runs per configuration. Every configuration ran on Claude Managed Agents. The charted team configuration is a run in which the Claude Fable 5.1 coordinator ran the whole sweep inside the platform at its documented limit of 25 concurrent Claude Sonnet 5 workers, run August 30, 2026; its three episodes scored F1 0.764, 0.825, and 0.791 after the extras audit (raw 0.751, 0.821, and 0.781) for \$225, \$234, and \$283. The Claude Sonnet 5 solo configuration ran August 3 to 4, 2026; the Claude Fable 5.1 solo configurations ran August 24 to 25, 2026, under the platform's launch serving settings, three seeds per effort setting, on the same corpus build. The sandbox image carried installed copies of part of the corpus, and Claude Fable 5.1's final assembly step compared against them in 7 of 9 episodes; re-grading without those additions moved the affected seeds by up to 3 points. Absolute F1 is specific to this corpus build, not comparable across benchmarks; configuration comparisons are like for like.
9. **GPQA Diamond:** Rein et al., "GPQA: A Graduate-Level Google-Proof Q&A Benchmark," 2023. The 198-question Diamond subset, two runs per configuration, run August 7, 2026 (Claude Opus 5.5: September 19, 2026), model-graded against reference answers, advisor tokens metered per request. A platform safety check refused two biology questions on the Claude Sonnet 5 executors, and one of them also on Claude Opus 5; excluding them changes no comparison by more than one point. Claude Opus 5.5's 92% comes from two runs that set `fallbacks: "default"` to opt into [server-side fallback](/docs/en/build-with-claude/refusals-and-fallback#server-side-fallback), with any attempt that still ended in a refusal counted as wrong. In each run the safety check flagged six biology questions, Claude Opus 5 answered five of them through the fallback, and the sixth still ended in a refusal. Opus 5.5's cost per question includes those fallback answers. Without counting refusals as wrong, these runs score 93%, because the grader still assigns an answer option to a refused attempt, usually the correct one. With refusals counted as wrong, Claude Opus 5's runs score 91% (one refusal per run), as do two Claude Opus 5.5 runs with fallback off, in which Opus 5.5 refused five or six biology questions per run.
10. **DeepSWE:** Datacurve, "DeepSWE: Measuring Frontier Coding Agents on Original, Long-Horizon Engineering Tasks," arXiv:2607.07946, 2026. The set has 113 original tasks across five languages with program-based verifiers. Pairings are two runs each, run August 7, 2026, with advisor tokens metered per request, and used a client-side advisor loop rather than the advisor tool, with identical accounting. Single-model effort sweeps are single runs priced from token counts, a cache-aware approximation. Costs per task are run totals divided by 113.
11. **Internal agentic-coding benchmark:** Anthropic-internal: 370 repository tasks graded by the repositories' own tests. The API figures were measured with a 128,000-token output cap, one run per configuration: Opus 5 alone at the default effort August 9 to 10, 2026, and at `low` and `medium` August 10, 2026; Claude Fable 5.1 alone at five explicitly set effort values August 20, 2026 (the chart shows three of them); and the pairing August 24 to 25, 2026. Claude Opus 5.5 alone ran on all 370 tasks, September 19 to 20, 2026: at its default effort (`medium`) and at `high` with five attempts per task, and at `low` and `xhigh` with one (369 of 370 scored at each, after a setup-check failure). The Claude Opus 5.5 executor at `high` with the released Claude Fable 5.1 as advisor (the August runs used a pre-release snapshot) ran five attempts per task on the same dates; one task failed its setup check, so 1,845 attempts were scored. The 279 attempts in which the advisor was turned away under load were re-run, and attempts whose consults timed out were kept, as in August. The August runs had five attempts per task for the pairing and the Claude Opus 5 control and one for the other points. The August pairing averaged about two advisor consultations per attempt; the Claude Opus 5.5 pairing requested 1.39 and received 1.35. Costs are per attempt. Costs are priced as a customer's organization is metered: each agent-loop request's prior prompt as a cache read and its new tokens as a 5-minute cache write, from the runs' own usage records, and each advisor call, which uses no cache, from its recorded tokens, all at list prices. The Claude Code figures are runs of the same tasks from July 8 to 23, 2026, one run per configuration, costs approximate.
12. **Internal repository-task benchmark (cap measurement):** A separate Anthropic-internal set of about 130 repository tasks, run August 20, 2026 (Claude Fable 5.1) and September 19, 2026 (Claude Opus 5.5, at its default effort, `medium`), with a plain API agent loop, one attempt per task. The Claude Fable 5.1 runs are 135 tasks per cap at the default effort set explicitly: the 16,384-token figure averages two runs (36.3% on both); the 64,000 and 128,000 figures are single runs (58.5% and 60.0%). Six problems drew a safety refusal in every run and count as failures. The Claude Opus 5.5 16,384-token figure averages two runs (134 and 135 tasks scored), and its 64,000 and 128,000 figures are single runs (135 tasks each); two attempts in each 16,384-token run ended in a safety refusal and count as failures. The SWE-bench Pro cap figures are one Claude Fable 5.1 run per cap at the default effort, run August 26, 2026, on a 100-problem subset stratified from reference 3's 482-problem set, not comparable to its scores; the two caps scored the same at the default. The chart's per-turn distributions come from the Claude Opus 5.5 and Claude Fable 5.1 runs at 128,000: no Opus 5.5 turn reached the cap (the longest was about 61,000 tokens, and 0.56% of its turns exceeded 16,384), and one Fable 5.1 turn reached 128,000 (0.46% of its turns exceeded 16,384).
13. **Chartography:** Surge AI, "Chartography," 2026. The complete released 100-question set, measured August 6 and 9, 2026 (Claude Opus 5 alone) and September 20, 2026 (Claude Opus 5.5), with Anthropic's implementation on Claude Managed Agents (standard cloud sandbox; advisor configurations use the Managed Agents advisor). Claude Sonnet 4.6 grades instead of the reference judge and the benchmark runs with tools, so scores compare across configurations here but not to the published leaderboard. They are also not comparable to the Chartography results in the Claude Opus 5.5 system card, which use a different grader and run at `max` effort. Two runs per configuration (three for Claude Opus 5.5), pooled; run-to-run spreads were up to 10 points. Costs are what a customer running the agent routinely is billed: each chart's first request reads the agent's shared system prompt and tools from the cache, as it does when another session of the same agent ran in the previous 5 minutes. A chart run on its own costs about \$0.03 more with Claude Opus 5 or Claude Opus 5.5 and about \$0.12 more with Claude Fable 5.1. The August figures are re-priced this way from the runs' usage records; the evaluation organization's own metering, which until September 10, 2026, billed Claude Opus 5's cache reads in 8,192-token blocks, overstated Claude Opus 5's costs. Costs exclude sandbox time, which added under 1% to the August runs. The Claude Fable 5.1 solo runs are from August 24, 2026, under the platform's launch serving settings, two runs per setting; six attempts hit the 15-minute session cap and score 0, and two charts per run were answered by Claude Opus 5 after a safety refusal. The Claude Opus 5 low-effort executor with a Claude Fable 5.1 advisor ran twice on August 30, 2026, under the same settings (63.0 and 67.0, mean 65.0, at \$0.47 a chart; the advisor was consulted on 88% of tasks in each run, and 4 of its 219 replies came from Claude Opus 5 instead, each after a production safety filter stopped the advisor's own reply). Claude Opus 5.5 ran at `low`, with server-side fallback off and a safety classifier judging every tool call: three runs alone (70, 68, and 68) and three with a Claude Fable 5.1 advisor configured (59, 63, and 63), in which it consulted the advisor on 1 of 300 tasks. The consult-rate comparison for the earlier pairings comes from rerunning the same configurations on the Messages API with a container tool set, August 10 to 11, 2026.
14. **Support-desk prompt-audit evaluation:** An Anthropic-constructed set of 44 support tickets with deterministic grading, run in early August 2026 and reported on August 8, 2026, under six system prompts, each adding to the same clean prompt one pattern common in prompts written for Claude Opus 4.8 and Claude Sonnet 4.6. Each chart point is one of three cases (older model, newer model on the same prompt, newer model after the audit) averaged over the six prompts and 44 tickets. The Opus 5 accuracy gain has a 95% confidence interval of 3 to 8 points; the Sonnet accuracy differences are within noise.
15. **Data-file question set:** An Anthropic-constructed set of 25 aggregate questions over a 1,862-row slice of a public liquor-sales CSV, with ground truth computed by pandas and exact-match grading, run on Claude Sonnet 5 and Claude Opus 5 with thinking disabled (the in-context arm cannot complete at the default), a 4,000-token output cap, and no prompt caching, three runs per configuration, run August 19, 2026. The file arm uploads the CSV through the Files API and uses the `code_execution_20260120` tool.
16. **Cache duration measurement:** The 20-issue triage job from [Trim input and context tokens](#trim-input-and-context-tokens), run on Claude Sonnet 5 on August 23, 2026, and on Claude Opus 5.5 on September 19 and 20, 2026, at its default effort (`medium`) and at `high`, on the Messages API with the same harness (for Claude Opus 5.5, a port of it that sends the same request bodies), the Claude Opus 5.5 cells with `max_tokens` raised to 4,096, with pauses inserted before a randomly chosen share of turns (none, 5%, 10%, and every turn at 6 minutes on all 20 issues on both models, plus every turn at 2 minutes on Claude Sonnet 5; 20-minute and 45-minute pauses on a 5-issue subset on both models). Claude Opus 5's keep-alive figures below come from the same job on August 23, 2026, with `max_tokens` raised to 4,096, on the same schedules except the 2-minute and 45-minute pauses. Three runs per cell, cost computed from each response's `usage` fields at list prices (for Claude Opus 5.5, \$4 input, \$5 5-minute write, \$8 1-hour write, \$0.20 cache read, and \$20 output per million tokens; Claude Sonnet 5 ran on an Anthropic-internal organization whose usage is metered the same way as a customer organization's), accuracy against the same gold labels. The Claude Opus 5.5 figures on this page cover both effort levels. The crossover is about 3.3% of turns on Claude Sonnet 5 and 3.1% to 3.2% on Claude Opus 5.5: the median of each session's break-even share, computed by the cost model from that session's turn-by-turn context sizes, over all 45 Claude Sonnet 5 twenty-issue sessions and the 36 Claude Opus 5.5 twenty-issue sessions at each effort level (every pause schedule run on the full job, under all three cache settings, three runs each; the 5-issue cells are not in it). In the 5% cell the 5-minute and 1-hour settings tied on Claude Sonnet 5, because that draw's pauses fell on small prefixes; on Claude Opus 5.5 they nearly tied. The page's 1-in-20 rule sits above the measured crossover. Claude Opus 5.5's time to first token after a pause was not measured. Anthropic measured keep-alive requests that refresh the 5-minute cache on Claude Sonnet 5 and Claude Opus 5 on August 23, 2026, and on Claude Opus 5.5 in the runs above, always sent with `max_tokens: 1`. On Claude Sonnet 5 they cost 7.7% less than the 1-hour setting with 5% of turns paused and about the same with 10%; on Claude Opus 5 no difference was measurable at either share; on both they cost more with a pause of 6 minutes or more before every turn. On Claude Opus 5.5 they cost 8% to 18% less than the 1-hour setting with 5% and 10% of turns paused (about 10% to 15% once between-session noise is removed by re-billing each keep-alive session's own tokens at 1-hour cache prices), and more with a pause before every turn: 4% to 6% more at 6 minutes, 9% to 10% at 20 minutes, and 56% to 58% at 45 minutes. Keep-alive saved more on Claude Opus 5.5 because each keep-alive request re-reads the prefix at the cache-read price: 0.05x the input price, against 0.1x on Claude Sonnet 5 and Claude Opus 5; Claude Opus 5's sessions, re-billed at Claude Opus 5.5's prices, show nearly the same savings as Claude Opus 5.5. Anthropic's pre-launch API tests on Claude Opus 5.5 show that a `max_tokens: 0` request writes the cache and that the next request reads it; whether such a request refreshes an existing entry was not measured on Opus 5.5. On Claude Fable 5.1, at 0.025x, keep-alive was cheaper even with a pause before every turn, except at 45-minute pauses (reference 19).
17. **Cache-read share in production:** Aggregated first-party Claude API usage for the 14 days ending August 23, 2026, direct API product only, Anthropic-internal organizations excluded, no organization identified. An organization-day counts as an agent loop when its requests carry tool definitions and tool results, its prompts hold 9 or more prior tool calls on average, caching was used, and it made at least 10 such requests (the API has no conversation identifier, so this stands in for conversation length): 303,003 organization-days across 106,487 organizations, median cache-read share 84.2% of all input tokens, upper quartile 91.7%. Use-case labels (the organization's declared use case, or otherwise its classified one) cover 74% of those organization-days and 99% of their tokens; coding organizations supply 87% of agentic input tokens and read a median 88.5% (90.9% at 25 or more prior tool calls), upper quartile 93.4%, with about 72% of coding organization-days at 80% or more; support, research, and data agents read 84% to 85%. The top decile of organization-days reads 95.9% or more for coding and 94.2% to 94.8% for support, research, data, and other agents. The request-level split at 25 or more prior tool calls comes from a six-hour sample: coding 92% read, 7% write, under 1% uncached. Unlabeled organizations, mostly small, read a median 11%. Organization-days with no tool definitions read a median 34.6%. An independent query over the same window that reconstructs conversations of 10 or more requests, rather than scoring organization-days, puts the median at 90.2%; the difference is scope, not data.
18. **Compaction timing measurement:** The triage agent's long variant from [Trim input and context tokens](#trim-input-and-context-tokens), run August 24, 2026, on Claude Sonnet 5 with the 5-minute cache, cost from the usage fields at list prices, five sessions per arm: a no-change arm at the default effort throughout (\$0.81 per session), and two arms that start at low effort and make the same two cache-breaking changes, a switch to the default effort and one added tool, either mid-session at requests 12 and 17 (\$0.95) or together on the first request after the first compaction (\$0.75). A fourth arm of six sessions, run August 25, 2026, made the same two changes on the request that triggered the first compaction (\$0.92 per session): that request's summarization pass wrote the 81,000-token context to the cache instead of reading it, so that pass cost \$0.21 against \$0.04 for the same pass in the boundary arm. Sessions first compacted at request 21 to 25 (16 of the 21 sessions at request 22), once the prompt passed the 80,000-token compaction trigger, and two no-change sessions compacted a second time near the end. The boundary arm's lower total than the no-change arm reflects its low-effort requests before the change and those second compactions rather than caching: the two arms' re-write costs differ by under a cent. The mid-session arm paid \$0.23 per session in cache re-writes; the difference between the mid-session and boundary arms was \$0.20 with a 95% confidence interval of \$0.11 to \$0.29. One mid-session session ran cheap (\$0.82) after its model mis-called the search tool following compaction and got empty results; it is included, and without it the arm averages \$0.98. Accuracy averaged 14.2 of 20 labels in each August 24 arm and 14.7 in the August 25 arm; cache reads were 91% of prompt tokens with no changes, 85% mid-session, 91% at the boundary, and 86% with the changes on the triggering request.
19. **Cache duration measurement on Claude Fable 5.1:** The same 20-issue triage job and harness as reference 16, run August 23 and August 26, 2026, on the Claude Fable 5.1 launch snapshot at its launch prices (\$10 input, \$12.50 5-minute write, \$20 1-hour write, \$0.25 cache read, \$50 output per million tokens), three settings per schedule: the 5-minute cache, the 1-hour cache, and the 5-minute cache kept warm by a `max_tokens: 0` request on the unchanged prefix every 4 minutes, timed from the previous request's start (the August 23 runs sent keep-alive requests with `max_tokens: 1`; in the August 26 cells reported here, every keep-alive request refreshed the cache and billed no output). Schedules: no pauses, 10% of turns, and every turn at 6 minutes on all 20 issues, and 45-minute pauses on the 5-issue subset; three runs per cell (six for the August 26 keep-alive cell with 45-minute pauses), cost computed from each response's `usage` fields at list prices, accuracy against the same gold labels (12 to 17 exact labels of 20). Per-session means on August 26 for the 5-minute, 1-hour, and keep-alive settings: no pauses \$2.42, \$3.09, \$2.29; 10% paused \$4.50, \$2.96, \$2.36; every turn \$22.89, \$3.01, \$2.62; the August 23 cells agree within 6%. The 45-minute figures (\$1.68, \$0.59, and \$0.71 per 5-issue session) are from a clean re-run on August 26 after a cache-billing incident spoiled that day's first cells; the August 23 runs gave \$1.67, \$0.58, and \$0.70. The crossover between the 5-minute and 1-hour settings is 3.1% of turns, the same measure as reference 16.
20. **Terminal-Bench 3:** the public terminal-agent benchmark's 74 tasks, run on [Claude Managed Agents](/docs/en/managed-agents/overview) with two custom tools, a shell and a file editor that the evaluation harness runs in each task's own container, in place of the platform's built-in tools, and otherwise at the platform's default settings for external accounts, two runs per model at `high` effort, August 27 to 28, 2026. These runs used Terminal-Bench version 3.0, and their scores are not comparable with the public Terminal-Bench leaderboard or with the Terminal-Bench 4.0 results in the Claude Opus 5.5 system card, which come from runs in Claude Code at `max` effort. Each task's time limits are 2.5 times the benchmark's own, which gives the agent between 75 minutes and 20 hours per task (5 hours for the median task), and each task gets three times the memory it specifies, from 6 GiB to 96 GiB, with extra memory for the 12 tasks that run helper services. The agent had no general internet access: its containers could reach an internal package mirror, a short list of download sites including GitHub and the Python Package Index, and a few sites specific to some tasks, and eight of the tasks had no network access at all. Scores are raw pass rates over the 148 attempts per model; single runs swing by 5 to 11 points. Costs are what a customer would be billed at list prices, re-priced request by request from the runs' usage records with the 5-minute cache lifetime. Claude Opus 4.7 ended 11 of its 148 attempts at its output cap.
21. **DRACO:** Perplexity, "DRACO: a Cross-Domain Benchmark for Deep Research Accuracy, Completeness, and Objectivity," arXiv:2602.11685, 2026. Its 100 research tasks across 10 domains are graded against expert-written rubrics, and the score is the benchmark's normalized score. Every configuration ran on the Claude API with Claude Fable 5.1, the default adaptive thinking, the production safety classifiers on, and `max_tokens` at 128,000: a single agent at `high` and at `medium` effort, the single agent at `high` with the instruction and the clock, and a team at `high` with and without them. The team is a lead agent that starts helper agents of the same model through a tool, with no cap on their number. On DRACO, the lead started a median of 4 helpers per attempt. Each configuration made three attempts at each task, run September 8 to 10, 2026. An attempt that hit the four-hour limit was run again, and the new attempt counts. The only attempts left out are all 3 attempts at one task for the single agent at `medium` effort, so that configuration covers 99 tasks. That task timed out on every attempt, in the original run and in the re-run. Scoring those 3 attempts as 0, as the benchmark's own scoring would, affects only the two comparisons with `medium` effort. The score change at `medium` effort against `high` moves from 0.7 to 1.7 points lower, and the score change with both changes against `medium` effort moves from 1.2 to 0.2 points lower. The agents used a search tool and a fetch tool that the evaluation harness hosts over a pinned web index. Those tools set part of the time, and yours will run at a different speed, so the page gives time as a ratio between configurations, not in minutes. Time is the wall-clock time per task, from the first request to the last request on any agent, minus the estimated time spent waiting to retry requests after rate-limit or overload errors. Those errors came from the test account's shared limits. All configurations of a set started together. The slower ones finished hours later, so part of their time ran under different load. Each task's cost is its requests priced at public list prices, with prompt caching billed as it would be for a customer who sets a cache breakpoint at the end of each request and uses the 5-minute cache lifetime, for model tokens only. The harness's tools add no charges. Score changes are paired differences over tasks, with 95% bootstrap intervals. A change counts as inside the margin when its interval stays within 1.5 points on DRACO and 2.5 points on HLE. Anthropic set those margins before the runs. Claude Opus 5 grades the answers. Against each set's own grader, Opus 5 scored 1.9 to 2.4 points higher on DRACO, 2.2 to 2.9 points lower on HLE (Opus 5 graded 495 of the 500 questions, and the benchmark's grader graded all 500), and 1.3 to 2.0 points lower on the physics set, whose own grader also uses the expert reference solutions, in every configuration. The two graders agree on the direction of every change.
22. **HLE:** Phan et al., "Humanity's Last Exam," arXiv:2501.14249, 2025. Expert-written questions with exact answers, graded against the reference answers. Measured on the first 500 questions, with the benchmark's own sources blocked from search, and the same setup as reference 21. Each configuration made three attempts at each question, run September 8 to 10, 2026. Claude Opus 5 compares each answer with the reference answer, with adaptive thinking on, as it is by default. The judge graded 495 of the 500 questions in every configuration, and the scores cover those 495. For the other 5, the grading request was over the judge's 1M-token limit. An attempt that hit the four-hour limit was run again, and the new attempt counts, so every configuration has all 1,500 attempts. Scoring the 5 ungraded questions as 0, as the benchmark's own scoring would, changes no finding.
23. **Physics set:** An internal set of 70 research-level physics problems, adapted from the public CritPt benchmark: Zhu et al., "Probing the Critical Point (CritPt) of AI Reasoning: a Frontier Physics Research Benchmark," arXiv:2509.26574, 2025. Expert reviewers corrected the problem statements. Claude Opus 5 grades each answer against expert reference solutions that aren't public, so the scores can't be compared with published results. The score is the mean grade over a problem's attempts, averaged over problems. Measured on all 70 problems, four attempts per problem, run September 8 to 9, 2026. Every agent had a Python tool, a shell, and a file editor in a sandbox container with no network access, and no search or fetch tools. Otherwise the setup is that of reference 21. No score margin was set for the physics set before the runs, so the page gives its score changes with their 95% intervals and doesn't describe them as inside a margin.
## Next steps
[Prompt caching](/docs/en/build-with-claude/prompt-caching)
The largest free win on this page: setup, lifetimes, and diagnostics.
[Effort](/docs/en/build-with-claude/effort)
Trade intelligence for latency and cost within a single model.
[Choosing the right model](/docs/en/about-claude/models/choosing-a-model)
Evaluate capability, speed, and cost across the Claude model family.
[Task budgets](/docs/en/build-with-claude/task-budgets)
Give agent loops a token countdown they self-regulate against.
[Session budgets](/docs/en/managed-agents/budgets)
Put a hard dollar cap on a Managed Agents session.
[Pricing](/docs/en/about-claude/pricing)
See current per-token pricing for every Claude model.
[Cookbook: cost optimization on the Claude API](https://platform.claude.com/cookbook/cost-optimization-cost-optimization)
Apply these levers one at a time to a working agent in a runnable notebook, with cost per task after each step.
[Webinar: Building on the Claude Platform](https://www.anthropic.com/webinars/building-on-the-claude-platform-claude-fable-5-and-model-orchestration-patterns)
Watch a walkthrough of the advisor and orchestrator patterns.
---
## about-claude-models-overview-2536dd9f05.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fmodels%2Foverview)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5](/docs/en/models/sonnet-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
Models & pricingModels
# Models overview
Claude is a family of state-of-the-art large language models developed by Anthropic. Compare the current lineup, find the model ID for every platform, and open each model's page for its full specs and resources.
Copy page
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Pricing](/docs/en/about-claude/pricing)[Migration guide](/docs/en/about-claude/models/migration-guide)
Copy page
## Compare models
If you're unsure which model to use, start with [Claude Opus 5.5](/docs/en/models/opus-5-5/overview) for most workloads. Use [Claude Fable 5.1](/docs/en/models/fable-5-1/overview) for demanding reasoning and long-horizon agentic work, or when your evals on Claude Opus 5.5 at higher effort still fall short. All current models support text and image input, text output, multilingual capabilities, vision, and tool use. Each model's page lists the platforms it's available on.
[TABLE]
Once you've picked a model, [learn how to make your first API call](/docs/en/get-started). To understand how model IDs, aliases, and snapshots work, see [Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions); for the reliable-knowledge and training-data cutoffs behind each model, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency).
## Using the Models API
You can query model capabilities and token limits programmatically with the [Models API](/docs/en/api/models/list). The response includes `max_input_tokens`, `max_tokens`, and a `capabilities` object for every available model.
## Prompt and output performance
Current Claude models excel in:
- **Performance:** Top-tier results in reasoning, coding, multilingual tasks, long-context handling, honesty, and image processing. See [Prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for general and model-specific prompting guidance.
- **Engaging responses:** Claude models are ideal for applications that require rich, human-like interactions. If you prefer more concise responses, adjust your prompts to guide the model toward the desired output length. Refer to the [prompt engineering guides](/docs/en/build-with-claude/prompt-engineering) for details.
- **Output quality:** When migrating from a previous model generation, you may notice larger improvements in overall performance. If you're on Claude Opus 5 or earlier, see [Migrating to Claude Opus 5.5](/docs/en/models/opus-5-5/migration-guide).
## Get started with Claude
If you're ready to start exploring what Claude can do for you, dive in! Whether you're a developer looking to integrate Claude into your applications or a user wanting to experience the power of AI firsthand, the following resources can help.
[Intro to Claude](/docs/en/intro)
Explore Claude's capabilities and development flow.
[Quickstart](/docs/en/get-started)
Learn how to make your first API call in minutes.
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)
Establish criteria and pick the right model for your use case.
[Pricing](/docs/en/about-claude/pricing)
Complete pricing, including batch discounts and prompt caching rates.
[Model deprecations](/docs/en/about-claude/model-deprecations)
Lifecycle status and retirement commitments for every model.
[Claude Console](/)
Craft and test prompts directly in your browser.
Looking to chat with Claude? Visit [claude.ai](https://claude.ai). If you have questions, reach out to the [support team](https://support.claude.com/) or the [Discord community](https://www.anthropic.com/discord).
---
## about-claude-models-overview-2bbf09ff82.md
# Models overview
Claude is a family of state-of-the-art large language models developed by Anthropic. This guide introduces the available models and compares their performance.
---
## Choosing a model
If you're unsure which model to use, consider starting with **Claude Opus 4.7** for the most complex tasks. It is our most capable generally available model, with a step-change improvement in agentic coding over Claude Opus 4.6.
All current Claude models support text and image input, text output, multilingual capabilities, and vision. Models are available via the Claude API, Amazon Bedrock, Vertex AI, and Microsoft Foundry.
Once you've picked a model, [learn how to make your first API call](/docs/en/get-started).
### Latest models comparison
| Feature | Claude Opus 4.7 | Claude Sonnet 4.6 | Claude Haiku 4.5 |
|:--------|:--------------|:------------------|:-----------------|
| **Description** | Our most capable generally available model for complex reasoning and agentic coding | The best combination of speed and intelligence | The fastest model with near-frontier intelligence |
| **Claude API ID** | claude-opus-4-7 | claude-sonnet-4-6 | claude-haiku-4-5-20251001 |
| **Claude API alias** | claude-opus-4-7 | claude-sonnet-4-6 | claude-haiku-4-5 |
| **AWS Bedrock ID** | anthropic.claude-opus-4-73 | anthropic.claude-sonnet-4-6 | anthropic.claude-haiku-4-5-20251001-v1:0 |
| **GCP Vertex AI ID** | claude-opus-4-7 | claude-sonnet-4-6 | claude-haiku-4-5@20251001 |
| **Pricing**1 | \$5 / input MTok \$25 / output MTok | \$3 / input MTok \$15 / output MTok | \$1 / input MTok \$5 / output MTok |
| **[Extended thinking](/docs/en/build-with-claude/extended-thinking)** | No | Yes | Yes |
| **[Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking)** | Yes | Yes | No |
| **[Priority Tier](/docs/en/api/service-tiers)** | Yes | Yes | Yes |
| **Comparative latency** | Moderate | Fast | Fastest |
| **Context window** | 1M tokens | 1M tokens | 200k tokens |
| **Max output** | 128k tokens | 64k tokens | 64k tokens |
| **Reliable knowledge cutoff** | Jan 20262 | Aug 20252 | Feb 2025 |
| **Training data cutoff** | Jan 2026 | Jan 2026 | Jul 2025 |
_1 - See the [pricing page](/docs/en/about-claude/pricing) for complete pricing information including batch API discounts, prompt caching rates, extended thinking costs, and vision processing fees._
_2 - **Reliable knowledge cutoff** indicates the date through which a model's knowledge is most extensive and reliable. **Training data cutoff** is the broader date range of training data used. For more information, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency)._
_3 - Claude Opus 4.7 on AWS is available through [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock) (the Messages-API Bedrock endpoint)._
[Claude Mythos Preview](https://anthropic.com/glasswing) is offered separately as a research preview model for defensive cybersecurity workflows as part of [Project Glasswing](https://anthropic.com/glasswing). Access is invitation-only and there is no self-serve sign-up.
Models with the same snapshot date (e.g., 20240620) are identical across all platforms and do not change. The snapshot date in the model name ensures consistency and allows developers to rely on stable performance across different environments.Starting with **Claude Sonnet 4.5 and all subsequent models** (including Claude Sonnet 4.6), AWS Bedrock offers two endpoint types: **global endpoints** (dynamic routing for maximum availability) and **regional endpoints** (guaranteed data routing through specific geographic regions). Google Vertex AI offers three endpoint types: global endpoints, **multi-region endpoints** (dynamic routing within a geographic area), and regional endpoints. For more information, see the [third-party platform pricing section](/docs/en/about-claude/pricing#third-party-platform-pricing).
You can query model capabilities and token limits programmatically with the [Models API](/docs/en/api/models/list). The response includes `max_input_tokens`, `max_tokens`, and a `capabilities` object for every available model.
The Max output values above apply to the synchronous Messages API. On the [Message Batches API](/docs/en/build-with-claude/batch-processing#extended-output-beta), Opus 4.7, Opus 4.6, and Sonnet 4.6 support up to 300k output tokens by using the `output-300k-2026-03-24` beta header.
The following models are still available. Consider migrating to current models for improved performance:
| Feature | Claude Opus 4.6 | Claude Sonnet 4.5 | Claude Opus 4.5 | Claude Opus 4.1 | Claude Sonnet 4 (deprecated) | Claude Opus 4 (deprecated) |
|:--------|:----------------|:------------------|:----------------|:----------------|:----------------|:--------------|
| **Claude API ID** | claude-opus-4-6 | claude-sonnet-4-5-20250929 | claude-opus-4-5-20251101 | claude-opus-4-1-20250805 | claude-sonnet-4-20250514 | claude-opus-4-20250514 |
| **Claude API alias** | claude-opus-4-6 | claude-sonnet-4-5 | claude-opus-4-5 | claude-opus-4-1 | claude-sonnet-4-0 | claude-opus-4-0 |
| **AWS Bedrock ID** | anthropic.claude-opus-4-6-v1 | anthropic.claude-sonnet-4-5-20250929-v1:0 | anthropic.claude-opus-4-5-20251101-v1:0 | anthropic.claude-opus-4-1-20250805-v1:0 | anthropic.claude-sonnet-4-20250514-v1:0 | anthropic.claude-opus-4-20250514-v1:0 |
| **GCP Vertex AI ID** | claude-opus-4-6 | claude-sonnet-4-5@20250929 | claude-opus-4-5@20251101 | claude-opus-4-1@20250805 | claude-sonnet-4@20250514 | claude-opus-4@20250514 |
| **Pricing** | \$5 / input MTok \$25 / output MTok | \$3 / input MTok \$15 / output MTok | \$5 / input MTok \$25 / output MTok | \$15 / input MTok \$75 / output MTok | \$3 / input MTok \$15 / output MTok | \$15 / input MTok \$75 / output MTok |
| **[Extended thinking](/docs/en/build-with-claude/extended-thinking)** | Yes | Yes | Yes | Yes | Yes | Yes |
| **[Priority Tier](/docs/en/api/service-tiers)** | Yes | Yes | Yes | Yes | Yes | Yes |
| **Comparative latency** | Moderate | Fast | Moderate | Moderate | Fast | Moderate |
| **Context window** | 1M tokens | 200k tokens | 200k tokens | 200k tokens | 200k tokens | 200k tokens |
| **Max output** | 128k tokens | 64k tokens | 64k tokens | 32k tokens | 64k tokens | 32k tokens |
| **Reliable knowledge cutoff** | May 20251 | Jan 20251 | May 20251 | Jan 20251 | Jan 20251 | Jan 20251 |
| **Training data cutoff** | Aug 2025 | Jul 2025 | Aug 2025 | Mar 2025 | Mar 2025 | Mar 2025 |
Claude Sonnet 4 (`claude-sonnet-4-20250514`) and Claude Opus 4 (`claude-opus-4-20250514`) are deprecated and will be retired on June 15, 2026. Migrate to [Claude Sonnet 4.6](/docs/en/about-claude/models/overview#latest-models-comparison) and [Claude Opus 4.7](/docs/en/about-claude/models/overview#latest-models-comparison) respectively before the retirement date.
See [model deprecations](/docs/en/about-claude/model-deprecations) for details.
_1 - **Reliable knowledge cutoff** indicates the date through which a model's knowledge is most extensive and reliable. **Training data cutoff** is the broader date range of training data used._
## Prompt and output performance
Claude 4 models excel in:
- **Performance**: Top-tier results in reasoning, coding, multilingual tasks, long-context handling, honesty, and image processing. See the [Claude 4 blog post](http://www.anthropic.com/news/claude-4) for more information.
- **Engaging responses**: Claude models are ideal for applications that require rich, human-like interactions.
- If you prefer more concise responses, you can adjust your prompts to guide the model toward the desired output length. Refer to the [prompt engineering guides](/docs/en/build-with-claude/prompt-engineering) for details.
- For prompting best practices, see the [prompting best practices guide](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices).
- **Output quality**: When migrating from previous model generations to Claude 4, you may notice larger improvements in overall performance.
## Migrating to Claude Opus 4.7
If you're currently using Claude Opus 4.6 or older Claude models, consider migrating to Claude Opus 4.7 to take advantage of improved intelligence and a step-change jump in agentic coding. For detailed migration instructions, see [Migrating to Claude Opus 4.7](/docs/en/about-claude/models/migration-guide).
## Get started with Claude
If you're ready to start exploring what Claude can do for you, dive in! Whether you're a developer looking to integrate Claude into your applications or a user wanting to experience the power of AI firsthand, the following resources can help.
Looking to chat with Claude? Visit [claude.ai](http://www.claude.ai)!
Explore Claude's capabilities and development flow.
Learn how to make your first API call in minutes.
Craft and test powerful prompts directly in your browser.
If you have any questions or need assistance, don't hesitate to reach out to the [support team](https://support.claude.com/) or consult the [Discord community](https://www.anthropic.com/discord).
---
## about-claude-models-overview-a06a84876f.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fmodels%2Foverview)
SearchCtrlK
Models
[Models overview](/docs/en/models/overview)
[Claude Fable 5.1](/docs/en/models/fable-5-1/overview)
[Claude Opus 5.5](/docs/en/models/opus-5-5/overview)
[Claude Sonnet 5](/docs/en/models/sonnet-5/overview)
[Claude Haiku 4.5](/docs/en/models/haiku-4-5/overview)
Specialized models
Legacy models
Guides
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)
Lifecycle and reference
[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[Pricing](/docs/en/about-claude/pricing)
[System prompts](/docs/en/release-notes/system-prompts/overview)
[Console](/)
Models & pricingModels
# Models overview
Claude is a family of state-of-the-art large language models developed by Anthropic. Compare the current lineup, find the model ID for every platform, and open each model's page for its full specs and resources.
Copy page
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Pricing](/docs/en/about-claude/pricing)[Migration guide](/docs/en/about-claude/models/migration-guide)
Copy page
## Compare models
If you're unsure which model to use, start with [Claude Opus 5.5](/docs/en/models/opus-5-5/overview) for most workloads. Use [Claude Fable 5.1](/docs/en/models/fable-5-1/overview) for demanding reasoning and long-horizon agentic work, or when your evals on Claude Opus 5.5 at higher effort still fall short. All current models support text and image input, text output, multilingual capabilities, vision, and tool use. Each model's page lists the platforms it's available on.
[TABLE]
Once you've picked a model, [learn how to make your first API call](/docs/en/get-started). To understand how model IDs, aliases, and snapshots work, see [Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions); for the reliable-knowledge and training-data cutoffs behind each model, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency).
## Using the Models API
You can query model capabilities and token limits programmatically with the [Models API](/docs/en/api/models/list). The response includes `max_input_tokens`, `max_tokens`, and a `capabilities` object for every available model.
## Prompt and output performance
Current Claude models excel in:
- **Performance:** Top-tier results in reasoning, coding, multilingual tasks, long-context handling, honesty, and image processing. See [Prompting best practices](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices) for general and model-specific prompting guidance.
- **Engaging responses:** Claude models are ideal for applications that require rich, human-like interactions. If you prefer more concise responses, adjust your prompts to guide the model toward the desired output length. Refer to the [prompt engineering guides](/docs/en/build-with-claude/prompt-engineering) for details.
- **Output quality:** When migrating from a previous model generation, you may notice larger improvements in overall performance. If you're on Claude Opus 5 or earlier, see [Migrating to Claude Opus 5.5](/docs/en/models/opus-5-5/migration-guide).
## Get started with Claude
If you're ready to start exploring what Claude can do for you, dive in! Whether you're a developer looking to integrate Claude into your applications or a user wanting to experience the power of AI firsthand, the following resources can help.
[Intro to Claude](/docs/en/intro)
Explore Claude's capabilities and development flow.
[Quickstart](/docs/en/get-started)
Learn how to make your first API call in minutes.
[Choosing a model](/docs/en/about-claude/models/choosing-a-model)
Establish criteria and pick the right model for your use case.
[Pricing](/docs/en/about-claude/pricing)
Complete pricing, including batch discounts and prompt caching rates.
[Model deprecations](/docs/en/about-claude/model-deprecations)
Lifecycle status and retirement commitments for every model.
[Claude Console](/)
Craft and test prompts directly in your browser.
Looking to chat with Claude? Visit [claude.ai](https://claude.ai). If you have questions, reach out to the [support team](https://support.claude.com/) or the [Discord community](https://www.anthropic.com/discord).
---
## about-claude-models-overview.md
# Models overview
Claude is a family of state-of-the-art large language models developed by Anthropic. This guide introduces the available models and compares their performance.
Choosing a model
If you're unsure which model to use, consider starting with **Claude Opus 4.6** for the most complex tasks. It is the latest generation model with exceptional performance in coding and reasoning.
All current Claude models support text and image input, text output, multilingual capabilities, and vision. Models are available via the Claude API, AWS Bedrock, and Google Vertex AI.
Once you've picked a model, [learn how to make your first API call](/docs/en/get-started).
Latest models comparison
[TABLE]
*^(1 - See the [pricing page](/docs/en/about-claude/pricing) for complete pricing information including batch API discounts, prompt caching rates, extended thinking costs, and vision processing fees.)*
*^(2 - **Reliable knowledge cutoff** indicates the date through which a model's knowledge is most extensive and reliable. **Training data cutoff** is the broader date range of training data used. For more information, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency).)*
Models with the same snapshot date (e.g., 20240620) are identical across all platforms and do not change. The snapshot date in the model name ensures consistency and allows developers to rely on stable performance across different environments.
Starting with **Claude Sonnet 4.5 and all subsequent models** (including Claude Sonnet 4.6), AWS Bedrock and Google Vertex AI offer two endpoint types: **global endpoints** (dynamic routing for maximum availability) and **regional endpoints** (guaranteed data routing through specific geographic regions). For more information, see the [third-party platform pricing section](/docs/en/about-claude/pricing#third-party-platform-pricing).
You can query model capabilities and token limits programmatically with the [Models API](/docs/en/api/models/list). The response includes `max_input_tokens`, `max_tokens`, and a `capabilities` object for every available model.
### Legacy models
Prompt and output performance
Claude 4 models excel in:
- **Performance**: Top-tier results in reasoning, coding, multilingual tasks, long-context handling, honesty, and image processing. See the [Claude 4 blog post](http://www.anthropic.com/news/claude-4) for more information.
- **Engaging responses**: Claude models are ideal for applications that require rich, human-like interactions.
- If you prefer more concise responses, you can adjust your prompts to guide the model toward the desired output length. Refer to the [prompt engineering guides](/docs/en/build-with-claude/prompt-engineering) for details.
- For prompting best practices, see the [prompting best practices guide](/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices).
- **Output quality**: When migrating from previous model generations to Claude 4, you may notice larger improvements in overall performance.
Migrating to Claude 4.6
If you're currently using older Claude models, consider migrating to Claude Opus 4.6 to take advantage of improved intelligence and enhanced capabilities. For detailed migration instructions, see [Migrating to Claude 4.6](/docs/en/about-claude/models/migration-guide).
Get started with Claude
If you're ready to start exploring what Claude can do for you, dive in! Whether you're a developer looking to integrate Claude into your applications or a user wanting to experience the power of AI firsthand, the following resources can help.
Looking to chat with Claude? Visit [claude.ai](http://www.claude.ai)!
Intro to Claude
Explore Claude's capabilities and development flow.
Quickstart
Learn how to make your first API call in minutes.
[](/)
Claude Console
Craft and test powerful prompts directly in your browser.
If you have any questions or need assistance, don't hesitate to reach out to the [support team](https://support.claude.com/) or consult the [Discord community](https://www.anthropic.com/discord).
---
## about-claude-models-whats-new-claude-4-5.md
Claude 4.5 introduces three models designed for different use cases:
Claude Opus 4.5: Our most intelligent model combining maximum capability with practical performance. Features a more accessible price point than previous Opus models. Available with a 200k token context window.
Claude Sonnet 4.5: Our best model for complex agents and coding, with the highest intelligence across most tasks. Available with a 200k and 1M (beta) token context window.
Claude Haiku 4.5: Our fastest and most intelligent Haiku model with near-frontier performance. Available with a 200k token context window.
Key improvements in Opus 4.5 over Opus 4.1
Maximum intelligence
Claude Opus 4.5 represents our most intelligent model, combining maximum capability with practical performance. It delivers step-change improvements across reasoning, coding, and complex problem-solving tasks while maintaining the high-quality outputs expected from the Opus family.
Effort parameter
Claude Opus 4.5 is the only model that supports the effort parameter, allowing you to control how many tokens Claude uses when responding. This gives you the ability to trade off between response thoroughness and token efficiency with a single model.
The effort parameter affects all tokens in the response, including text responses, tool calls, and extended thinking. You can choose between:
High effort: Maximum thoroughness for complex analysis and detailed explanations
Medium effort: Balanced approach for most production use cases
Low effort: Most token-efficient responses for high-volume automation
Computer use excellence
Claude Opus 4.5 introduces enhanced computer use capabilities with a new zoom action that enables detailed inspection of specific screen regions at full resolution. This allows Claude to examine fine-grained UI elements, small text, and detailed visual information that might be unclear in standard screenshots.
The zoom capability is particularly valuable for:
Inspecting small UI elements and controls
Reading fine print or detailed text
Analyzing complex interfaces with dense information
Verifying precise visual details before taking actions
Practical performance
Claude Opus 4.5 delivers flagship intelligence at a more accessible price point than previous Opus models, making advanced AI capabilities available for a broader range of applications and use cases.
Thinking block preservation
Claude Opus 4.5 automatically preserves all previous thinking blocks throughout conversations, maintaining reasoning continuity across extended multi-turn interactions and tool use sessions. This ensures Claude can effectively leverage its full reasoning history when working on complex, long-running tasks.
Key improvements in Sonnet 4.5 over Sonnet 4
Coding excellence
Claude Sonnet 4.5 is our best coding model to date, with significant improvements across the entire development lifecycle:
SWE-bench Verified performance: Advanced state-of-the-art on coding benchmarks
Enhanced planning and system design: Better architectural decisions and code organization
Improved security engineering: More robust security practices and vulnerability detection
Better instruction following: More precise adherence to coding specifications and requirements
Claude Sonnet 4.5 performs significantly better on coding tasks when extended thinking is enabled. Extended thinking is disabled by default, but we recommend enabling it for complex coding work. Be aware that extended thinking impacts prompt caching efficiency. See the migration guide for configuration details.
Agent capabilities
Claude Sonnet 4.5 introduces major advances in agent capabilities:
Extended autonomous operation: Sonnet 4.5 can work independently for hours while maintaining clarity and focus on incremental progress. The model makes steady advances on a few tasks at a time rather than attempting everything at once. It provides fact-based progress updates that accurately reflect what has been accomplished.
Context awareness: Claude now tracks its token usage throughout conversations, receiving updates after each tool call. This awareness helps prevent premature task abandonment and enables more effective execution on long-running tasks. See Context awareness for technical details and prompting guidance.
Enhanced tool usage: The model more effectively uses parallel tool calls, firing off multiple speculative searches simultaneously during research and reading several files at once to build context faster. Improved coordination across multiple tools and information sources enables the model to effectively leverage a wide range of capabilities in agentic search and coding workflows.
Advanced context management: Sonnet 4.5 maintains exceptional state tracking in external files, preserving goal-orientation across sessions. Combined with more effective context window usage and our new context management API features, the model optimally handles information across extended sessions to maintain coherence over time.
Context awareness is available in Claude Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus 4, Opus 4.1, and Opus 4.5.
Communication and interaction style
Claude Sonnet 4.5 has a refined communication approach that is concise, direct, and natural. It provides fact-based progress updates and may skip verbose summaries after tool calls to maintain workflow momentum (though this can be adjusted with prompting).
For detailed guidance on working with this communication style, see Claude 4 best practices.
Creative content generation
Claude Sonnet 4.5 excels at creative content tasks:
Presentations and animations: Matches or exceeds Claude Opus 4.1 and Opus 4.5 for creating slides and visual content
Creative flair: Produces polished, professional output with strong instruction following
First-try quality: Generates usable, well-designed content in initial attempts
Key improvements in Haiku 4.5 over Haiku 3.5
Claude Haiku 4.5 represents a transformative leap for the Haiku model family, bringing frontier capabilities to our fastest model class:
Near-frontier intelligence with blazing speed
Claude Haiku 4.5 delivers near-frontier performance matching Sonnet 4 at significantly lower cost and faster speed:
Near-frontier intelligence: Matches Sonnet 4 performance across reasoning, coding, and complex tasks
Enhanced speed: More than twice the speed of Sonnet 4, with optimizations for output tokens per second (OTPS)
Optimal cost-performance: Near-frontier intelligence at one-third the cost, ideal for high-volume deployments
Extended thinking capabilities
Claude Haiku 4.5 is the first Haiku model to support extended thinking, bringing advanced reasoning capabilities to the Haiku family:
Reasoning at speed: Access to Claude's internal reasoning process for complex problem-solving
Thinking Summarization: Summarized thinking output for production-ready deployments
Interleaved thinking: Think between tool calls for more sophisticated multi-step workflows
Budget control: Configure thinking token budgets to balance reasoning depth with speed
Extended thinking must be enabled explicitly by adding a thinking parameter to your API requests. See the Extended thinking documentation for implementation details.
Claude Haiku 4.5 performs significantly better on coding and reasoning tasks when extended thinking is enabled. Extended thinking is disabled by default, but we recommend enabling it for complex problem-solving, coding work, and multi-step reasoning. Be aware that extended thinking impacts prompt caching efficiency. See the migration guide for configuration details.
Available in Claude Sonnet 3.7, Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus 4, Opus 4.1, and Opus 4.5.
Context awareness
Claude Haiku 4.5 features context awareness, enabling the model to track its remaining context window throughout a conversation:
Token budget tracking: Claude receives real-time updates on remaining context capacity after each tool call
Better task persistence: The model can execute tasks more effectively by understanding available working space
Multi-context-window workflows: Improved handling of state transitions across extended sessions
This is the first Haiku model with native context awareness capabilities. For prompting guidance, see Claude 4 best practices.
Available in Claude Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus 4, Opus 4.1, and Opus 4.5.
Strong coding and tool use
Claude Haiku 4.5 delivers robust coding capabilities expected from modern Claude models:
Coding proficiency: Strong performance across code generation, debugging, and refactoring tasks
Full tool support: Compatible with all Claude 4 tools including bash, code execution, text editor, web search, and computer use
Enhanced computer use: Optimized for autonomous desktop interaction and browser automation workflows
Parallel tool execution: Efficient coordination across multiple tools for complex workflows
Haiku 4.5 is designed for use cases that demand both intelligence and efficiency:
Real-time applications: Fast response times for interactive user experiences
High-volume processing: Cost-effective intelligence for large-scale deployments
Free tier implementations: Premium model quality at accessible pricing
Sub-agent architectures: Fast, intelligent agents for multi-agent systems
Computer use at scale: Cost-effective autonomous desktop and browser automation
New API features
Programmatic tool calling (Beta)
Programmatic tool calling allows Claude to write code that calls your tools programmatically within a code execution container, rather than requiring round trips through the model for each tool invocation. This significantly reduces latency for multi-tool workflows and decreases token consumption by allowing Claude to filter or process data before it reaches the model's context window.
tools=[
{
"type": "code_execution_20250825",
"name": "code_execution"
},
{
"name": "query_database",
"description": "Execute a SQL query against the sales database. Returns a list of rows as JSON objects.",
"input_schema": {...},
"allowed_callers": ["code_execution_20250825"] # Enable programmatic calling
}
]
Key benefits:
Reduced latency: Eliminate model round-trips between tool calls
Token efficiency: Process and filter tool results programmatically before returning to Claude
Complex workflows: Support loops, conditional logic, and batch processing
Available in Claude Opus 4.5 and Claude Sonnet 4.5. Requires beta header: advanced-tool-use-2025-11-20
Tool search tool (Beta)
The tool search tool enables Claude to work with hundreds or thousands of tools by dynamically discovering and loading them on-demand. Instead of loading all tool definitions into the context window upfront, Claude searches your tool catalog and loads only the tools it needs.
Two search variants are available:
Regex (tool_search_tool_regex_20251119): Claude constructs regex patterns to search tool names, descriptions, and arguments
BM25 (tool_search_tool_bm25_20251119): Claude uses natural language queries to search for tools
tools=[
{
"type": "tool_search_tool_regex_20251119",
"name": "tool_search_tool_regex"
},
{
"name": "get_weather",
"description": "Get the weather at a specific location",
"input_schema": {...},
"defer_loading": True # Load on-demand via search
}
]
This approach solves two critical challenges:
Context efficiency: Save 10-20K tokens by not loading all tool definitions upfront
Tool selection accuracy: Maintain high accuracy even with 100+ available tools
Available in Claude Opus 4.5 and Claude Sonnet 4.5. Requires beta header: advanced-tool-use-2025-11-20
Effort parameter (Beta)
The effort parameter allows you to control how many tokens Claude uses when responding, trading off between response thoroughness and token efficiency:
response = client.beta.messages.create(
model="claude-opus-4-5-20251101",
betas=["effort-2025-11-24"],
max_tokens=4096,
messages=[{"role": "user", "content": "..."}],
output_config={
"effort": "medium" # "low", "medium", or "high"
}
)
The effort parameter affects all tokens in the response, including text responses, tool calls, and extended thinking. Lower effort levels produce more concise responses with minimal explanations, while higher effort provides detailed reasoning and comprehensive answers.
Available exclusively in Claude Opus 4.5. Requires beta header: effort-2025-11-24
Tool use examples (Beta)
Tool use examples allow you to provide concrete examples of valid tool inputs to help Claude understand how to use your tools more effectively. This is particularly useful for complex tools with nested objects, optional parameters, or format-sensitive inputs.
tools=[
{
"name": "get_weather",
"description": "Get the current weather in a given location",
"input_schema": {...},
"input_examples": [
{
"location": "San Francisco, CA",
"unit": "fahrenheit"
},
{
"location": "Tokyo, Japan",
"unit": "celsius"
},
{
"location": "New York, NY" # Demonstrates optional 'unit' parameter
}
]
}
]
Examples are included in the prompt alongside your tool schema, showing Claude concrete patterns for well-formed tool calls. Each example must be valid according to the tool's input_schema.
Available in Claude Sonnet 4.5, Haiku 4.5, Opus 4.5, Opus 4.1, and Opus 4. Requires beta header: advanced-tool-use-2025-11-20.
Memory tool (Beta)
The new memory tool enables Claude to store and retrieve information outside the context window:
tools=[
{
"type": "memory_20250818",
"name": "memory"
}
]
This allows for:
Building knowledge bases over time
Maintaining project state across sessions
Preserving effectively unlimited context through file-based storage
Available in Claude Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus 4, Opus 4.1, and Opus 4.5. Requires beta header: context-management-2025-06-27
Context editing
Use context editing for intelligent context management through automatic tool call clearing:
response = client.beta.messages.create(
betas=["context-management-2025-06-27"],
model="claude-sonnet-4-5", # or claude-haiku-4-5
max_tokens=4096,
messages=[{"role": "user", "content": "..."}],
context_management={
"edits": [
{
"type": "clear_tool_uses_20250919",
"trigger": {"type": "input_tokens", "value": 500},
"keep": {"type": "tool_uses", "value": 2},
"clear_at_least": {"type": "input_tokens", "value": 100}
}
]
},
tools=[...]
)
This feature automatically removes older tool calls and results when approaching token limits, helping manage context in long-running agent sessions.
Available in Claude Sonnet 4, Sonnet 4.5, Haiku 4.5, Opus 4, Opus 4.1, and Opus 4.5. Requires beta header: context-management-2025-06-27
Enhanced stop reasons
Claude 4.5 models introduce a new model_context_window_exceeded stop reason that explicitly indicates when generation stopped due to hitting the context window limit, rather than the requested max_tokens limit. This makes it easier to handle context window limits in your application logic.
{
"stop_reason": "model_context_window_exceeded",
"usage": {
"input_tokens": 150000,
"output_tokens": 49950
}
}
Improved tool parameter handling
Claude 4.5 models include a bug fix that preserves intentional formatting in tool call string parameters. Previously, trailing newlines in string parameters were sometimes incorrectly stripped. This fix ensures that tools requiring precise formatting (like text editors) receive parameters exactly as intended.
This is a behind-the-scenes improvement with no API changes required. However, tools with string parameters may now receive values with trailing newlines that were previously stripped.
Example:
// Before: Final newline accidentally stripped
{
"type": "tool_use",
"id": "toolu_01A09q90qw90lq917835lq9",
"name": "edit_todo",
"input": {
"file": "todo.txt",
"contents": "1. Chop onions.\n2. ???\n3. Profit"
}
}
// After: Trailing newline preserved as intended
{
"type": "tool_use",
"id": "toolu_01A09q90qw90lq917835lq9",
"name": "edit_todo",
"input": {
"file": "todo.txt",
"contents": "1. Chop onions.\n2. ???\n3. Profit\n"
}
}
Token count optimizations
Claude 4.5 models include automatic optimizations to improve model performance. These optimizations may add small amounts of tokens to requests, but you are not billed for these system-added tokens.
Features introduced in Claude 4
The following features were introduced in Claude 4 and are available across Claude 4 models, including Claude Sonnet 4.5 and Claude Haiku 4.5.
New refusal stop reason
Claude 4 models introduce a new refusal stop reason for content that the model declines to generate for safety reasons:
{
"id": "msg_014XEDjypDjFzgKVWdFUXxZP",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-4-5",
"content": [{"type": "text", "text": "I would be happy to assist you. You can "}],
"stop_reason": "refusal",
"stop_sequence": null,
"usage": {
"input_tokens": 564,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 22
}
}
When using Claude 4 models, you should update your application to handle refusal stop reasons.
Summarized thinking
With extended thinking enabled, the Messages API for Claude 4 models returns a summary of Claude's full thinking process. Summarized thinking provides the full intelligence benefits of extended thinking, while preventing misuse.
While the API is consistent across Claude 3.7 and 4 models, streaming responses for extended thinking might return in a "chunky" delivery pattern, with possible delays between streaming events.
Summarization is processed by a different model than the one you target in your requests. The thinking model does not see the summarized output.
For more information, see the Extended thinking documentation.
Interleaved thinking
Claude 4 models support interleaving tool use with extended thinking, allowing for more natural conversations where tool uses and responses can be mixed with regular messages.
Interleaved thinking is in beta. To enable interleaved thinking, add the beta header interleaved-thinking-2025-05-14 to your API request.
For more information, see the Extended thinking documentation.
Behavioral differences
Claude 4 models have notable behavioral changes that may affect how you structure prompts:
Communication style changes
More concise and direct: Claude 4 models communicate more efficiently, with less verbose explanations
More natural tone: Responses are slightly more conversational and less machine-like
Efficiency-focused: May skip detailed summaries after completing actions to maintain workflow momentum (you can prompt for more detail if needed)
Instruction following
Claude 4 models are trained for precise instruction following and require more explicit direction:
Be explicit about actions: Use direct language like "Make these changes" or "Implement this feature" rather than "Can you suggest changes" if you want Claude to take action
State desired behaviors clearly: Claude will follow instructions precisely, so being specific about what you want helps achieve better results
For comprehensive guidance on working with these models, see Claude 4 prompt engineering best practices.
Updated text editor tool
The text editor tool has been updated for Claude 4 models with the following changes:
Tool type: text_editor_20250728
Tool name: str_replace_based_edit_tool
The undo_edit command is no longer supported
The str_replace_editor text editor tool remains the same for Claude Sonnet 3.7.
If you're migrating from Claude Sonnet 3.7 and using the text editor tool:
# Claude Sonnet 3.7
tools=[
{
"type": "text_editor_20250124",
"name": "str_replace_editor"
}
]
# Claude 4 models
tools=[
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool"
}
]
For more information, see the Text editor tool documentation.
Updated code execution tool
If you're using the code execution tool, ensure you're using the latest version code_execution_20250825, which adds Bash commands and file manipulation capabilities.
The legacy version code_execution_20250522 (Python only) is still available but not recommended for new implementations.
For migration instructions, see the Code execution tool documentation.
Pricing and availability
Pricing
Claude 4.5 models maintain competitive pricing:
Model Input Output
Claude Opus 4.5 $5 per million tokens $25 per million tokens
Claude Sonnet 4.5 $3 per million tokens $15 per million tokens
Claude Haiku 4.5 $1 per million tokens $5 per million tokens
For more details, see the pricing documentation.
Third-party platform pricing
Starting with Claude 4.5 models (Opus 4.5, Sonnet 4.5, and Haiku 4.5), AWS Bedrock and Google Vertex AI offer two endpoint types:
Global endpoints: Dynamic routing for maximum availability
Regional endpoints: Guaranteed data routing through specific geographic regions with a 10% pricing premium
This regional pricing applies to all Claude 4.5 models: Opus 4.5, Sonnet 4.5, and Haiku 4.5.
The Claude API (1P) is global by default and unaffected by this change. The Claude API is global-only (equivalent to the global endpoint offering and pricing from other providers).
For implementation details and migration guidance:
AWS Bedrock global vs regional endpoints
Google Vertex AI global vs regional endpoints
Availability
Claude 4.5 models are available on:
Model Claude API Amazon Bedrock Google Cloud Vertex AI
Claude Opus 4.5 claude-opus-4-5-20251101 anthropic.claude-opus-4-5-20251101-v1:0 claude-opus-4-5@20251101
Claude Sonnet 4.5 claude-sonnet-4-5-20250929 anthropic.claude-sonnet-4-5-20250929-v1:0 claude-sonnet-4-5@20250929
Claude Haiku 4.5 claude-haiku-4-5-20251001 anthropic.claude-haiku-4-5-20251001-v1:0 claude-haiku-4-5@20251001
Also available through Claude.ai and Claude Code platforms.
Migration guide
Breaking changes and migration requirements vary depending on which model you're upgrading from. For detailed migration instructions, including step-by-step guides, breaking changes, and migration checklists, see Migrating to Claude 4.5.
The migration guide covers the following scenarios:
Claude Sonnet 3.7 → Sonnet 4.5: Complete migration path with breaking changes
Claude Haiku 3.5 → Haiku 4.5: Complete migration path with breaking changes
Claude Sonnet 4 → Sonnet 4.5: Quick upgrade with minimal changes
Claude Opus 4.1 → Sonnet 4.5: Seamless upgrade with no breaking changes
Claude Opus 4.1 → Opus 4.5: Seamless upgrade with no breaking changes
Claude Opus 4.5 → Sonnet 4.5: Seamless downgrade with no breaking changes
Next steps
Best practices
Learn prompt engineering techniques for Claude 4.5 models
Model overview
Compare Claude 4.5 models with other Claude models
Migration guide
Upgrade from previous models
---
## about-claude-models-whats-new-claude-4-6.md
# What's new in Claude 4.6
Overview of new features and capabilities in Claude Opus 4.6 and Sonnet 4.6.
Claude 4.6 represents the next generation of Claude models, bringing significant new capabilities and API improvements. This page summarizes all new features available at launch.
New models
| Model | API model ID | Description |
|----|----|----|
| Claude Opus 4.6 | `claude-opus-4-6` | The most intelligent model for building agents and coding |
| Claude Sonnet 4.6 | `claude-sonnet-4-6` | The best combination of speed and intelligence |
Claude Opus 4.6 and Sonnet 4.6 both support a [1M token context window](/docs/en/build-with-claude/context-windows), extended thinking, and all existing Claude API features. Opus 4.6 offers 128k max output tokens; Sonnet 4.6 offers 64k max output tokens.
For complete pricing and specs, see the [models overview](/docs/en/about-claude/models/overview).
New features
Adaptive thinking mode
[Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) (`thinking: {type: "adaptive"}`) is the recommended thinking mode for Opus 4.6 and Sonnet 4.6. Claude dynamically decides when and how much to think. At the default effort level (`high`), Claude almost always thinks. At lower effort levels, it may skip thinking for simpler problems.
`thinking: {type: "enabled"}` and `budget_tokens` are **deprecated** on Opus 4.6 and Sonnet 4.6. They remain functional but will be removed in a future model release. Use adaptive thinking and the [effort parameter](/docs/en/build-with-claude/effort) to control thinking depth instead. Adaptive thinking also automatically enables interleaved thinking.
```python
response = client.messages.create(
model="claude-opus-4-6",
max_tokens=16000,
thinking={"type": "adaptive"},
messages=[{"role": "user", "content": "Solve this complex problem..."}],
)
```
Effort parameter GA
The [effort parameter](/docs/en/build-with-claude/effort) is now generally available (no beta header required). A new `max` effort level provides the absolute highest capability on Opus 4.6. Combine effort with adaptive thinking for optimal cost-quality tradeoffs.
Sonnet 4.6 introduces the effort parameter to the Sonnet family. Consider setting effort to `medium` for most Sonnet 4.6 use cases to balance speed, cost, and performance.
Code execution is now free with web tools
[Code execution](/docs/en/agents-and-tools/tool-use/code-execution-tool) is now free when used with [web search](/docs/en/agents-and-tools/tool-use/web-search-tool) or [web fetch](/docs/en/agents-and-tools/tool-use/web-fetch-tool). When either tool is included in your API request, there are no additional charges for code execution beyond standard input and output token costs. Code execution enables dynamic filtering in web search and web fetch tools, improving accuracy while reducing token consumption. See the [code execution pricing](/docs/en/agents-and-tools/tool-use/code-execution-tool#usage-and-pricing) for details on standalone usage.
Improved web search and web fetch with dynamic filtering
[Web search](/docs/en/agents-and-tools/tool-use/web-search-tool) and [web fetch](/docs/en/agents-and-tools/tool-use/web-fetch-tool) tools now support dynamic filtering with Opus 4.6 and Sonnet 4.6. Claude can write and execute code to filter results before they reach the context window, keeping only relevant information and improving accuracy while reducing token consumption. To enable dynamic filtering, use the `web_search_20260209` or `web_fetch_20260209` tool versions.
Tools graduating to general availability
The following tools are now generally available:
- [Code execution](/docs/en/agents-and-tools/tool-use/code-execution-tool) (free with web tools)
- [Web fetch](/docs/en/agents-and-tools/tool-use/web-fetch-tool)
- [Programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling)
- [Tool search tool](/docs/en/agents-and-tools/tool-use/tool-search-tool)
- [Tool use examples](/docs/en/agents-and-tools/tool-use/implement-tool-use#providing-tool-use-examples)
- [Memory tool](/docs/en/agents-and-tools/tool-use/memory-tool)
Compaction API (beta)
[Compaction](/docs/en/build-with-claude/compaction) provides automatic, server-side context summarization, enabling effectively infinite conversations. When context approaches the window limit, the API automatically summarizes earlier parts of the conversation.
Fast mode (beta: research preview)
[Fast mode](/docs/en/build-with-claude/fast-mode) (`speed: "fast"`) delivers significantly faster output token generation for Opus models. Fast mode is up to 2.5x as fast at premium pricing (\$30/\$150 per MTok). This is the same model running with faster inference (no change to intelligence or capabilities).
```python
response = client.beta.messages.create(
model="claude-opus-4-6",
max_tokens=4096,
speed="fast",
betas=["fast-mode-2026-02-01"],
messages=[{"role": "user", "content": "Refactor this module..."}],
)
```
Fine-grained tool streaming (GA)
[Fine-grained tool streaming](/docs/en/agents-and-tools/tool-use/fine-grained-tool-streaming) is now generally available on all models and platforms. No beta header is required.
128k output tokens
Opus 4.6 supports up to 128k output tokens, doubling the previous 64k limit. This enables longer thinking budgets and more comprehensive responses. The SDKs require streaming for requests with large `max_tokens` values to avoid HTTP timeouts. If you don't need to process events incrementally, use `.stream()` with `.get_final_message()` to get the complete response. See [Streaming Messages](/docs/en/build-with-claude/streaming#get-the-final-message-without-handling-events) for details.
Data residency controls
[Data residency controls](/docs/en/build-with-claude/data-residency) allow you to specify where model inference runs using the `inference_geo` parameter. You can choose `"global"` (default) or `"us"` routing per request. US-only inference is priced at 1.1x on Claude Opus 4.6 and newer models.
Deprecations
`type: "enabled"` and `budget_tokens`
`thinking: {type: "enabled", budget_tokens: N}` is **deprecated** on Opus 4.6. It remains functional but will be removed in a future model release. Migrate to `thinking: {type: "adaptive"}` with the [effort parameter](/docs/en/build-with-claude/effort).
`interleaved-thinking-2025-05-14` beta header
The `interleaved-thinking-2025-05-14` beta header is **deprecated** on Opus 4.6. It is safely ignored if included, but is no longer required. [Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) automatically enables [interleaved thinking](/docs/en/build-with-claude/extended-thinking#interleaved-thinking). Remove `betas=["interleaved-thinking-2025-05-14"]` from your requests when using Opus 4.6.
**Sonnet 4.6** continues to support the `interleaved-thinking-2025-05-14` beta header for use with manual extended thinking (`thinking: {type: "enabled"}`). You can use either interleaved thinking with the beta header or adaptive thinking on Sonnet 4.6.
`output_format`
The `output_format` parameter for [structured outputs](/docs/en/build-with-claude/structured-outputs) has been moved to `output_config.format`. The old parameter remains functional but is deprecated and will be removed in a future model release.
```python
# Before
response = client.messages.create(
output_format={"type": "json_schema", "schema": {...}},
# ...
)
# After
response = client.messages.create(
output_config={"format": {"type": "json_schema", "schema": {...}}},
# ...
)
```
Breaking changes
Prefill removal
Prefilling assistant messages (last-assistant-turn prefills) is **not supported** on Opus 4.6. Requests with prefilled assistant messages return a 400 error.
**Alternatives:**
- [Structured outputs](/docs/en/build-with-claude/structured-outputs) for controlling response format
- System prompt instructions for guiding response style
- [`output_config.format`](/docs/en/build-with-claude/structured-outputs#json-outputs) for JSON output
Tool parameter quoting
Opus 4.6 may produce slightly different JSON string escaping in tool call arguments (e.g., different handling of Unicode escapes or forward slash escaping). Standard JSON parsers handle these differences automatically. If you parse tool call `input` as a raw string rather than using `json.loads()` or `JSON.parse()`, verify your parsing logic still works.
Migration guide
For step-by-step migration instructions, see [Migrating to Claude 4.6](/docs/en/about-claude/models/migration-guide).
Next steps
Adaptive thinking
Learn how to use adaptive thinking mode.
Models overview
Compare all Claude models.
Compaction
Explore server-side context compaction.
Fast mode
Faster output token generation for Opus models.
Migration guide
Step-by-step migration instructions.
---
## about-claude-models-whats-new-claude-4-7-3e4989177d.md
# What's new in Claude Opus 4.7
Overview of new features, breaking changes, and behavior changes in Claude Opus 4.7.
---
Claude Opus 4.7 is our most capable generally available model to date. It is highly autonomous and performs exceptionally well on long-horizon agentic work, knowledge work, vision tasks, and memory tasks. This page summarizes everything new at launch.
## New model
| Model | API model ID | Description |
|:------|:-------------|:------------|
| Claude Opus 4.7 | `claude-opus-4-7` | Our most capable generally available model for complex reasoning and agentic coding |
Claude Opus 4.7 supports the [1M token context window](/docs/en/build-with-claude/context-windows), 128k max output tokens, [adaptive thinking](/docs/en/build-with-claude/adaptive-thinking), and the same set of tools and platform features as Claude Opus 4.6.
For complete pricing and specs, see the [models overview](/docs/en/about-claude/models/overview).
## New features
### High-resolution image support
Claude Opus 4.7 is our first Claude model with high-resolution image support. Maximum image resolution has increased to **2576px / 3.75MP** (increased from our previous limit of 1568px / 1.15MP). This change should unlock performance gains on vision-heavy workloads, and is particularly important for computer use and screenshot/artifact/document understanding workflows.
Additionally, operations like mapping coordinates to images are now simpler — the model's coordinates are 1\:1 with actual pixels, so there's no scale-factor math required.
High-res images use more tokens. If the additional image fidelity is unnecessary, downsample images before sending to Claude to avoid token-usage increases.
Beyond resolution, Claude Opus 4.7 also improves on:
- **Low-level perception** — pointing, measuring, counting, and similar tasks.
- **Image localization** — natural-image bounding-box localization and detection are improved.
See [Images and vision](/docs/en/build-with-claude/vision) for details.
### New `xhigh` effort level
The [effort parameter](/docs/en/build-with-claude/effort) allows you to tune Claude's intelligence vs. token spend, trading off capability for faster speed and lower costs. Start with the new `xhigh` effort level for coding and agentic use cases, and use a minimum of `high` effort for most intelligence-sensitive use cases. See [Recommended effort levels for Claude Opus 4.7](/docs/en/build-with-claude/effort#recommended-effort-levels-for-claude-opus-4-7) for per-level guidance. (Messages API only; Claude Managed Agents handles effort automatically.)
### Task budgets (beta)
Claude Opus 4.7 introduces [task budgets](/docs/en/build-with-claude/task-budgets). A task budget gives Claude a rough estimate of how many tokens to target for a full agentic loop, including thinking, tool calls, tool results, and final output. The model sees a running countdown and uses it to prioritize work and finish the task gracefully as the budget is consumed. To use, set the beta header `task-budgets-2026-03-13` and add the following to your output config:
```python Python
response = client.beta.messages.create(
model="claude-opus-4-7",
max_tokens=128000,
output_config={
"effort": "high",
"task_budget": {"type": "tokens", "total": 128000},
},
messages=[
{"role": "user", "content": "Review the codebase and propose a refactor plan."}
],
betas=["task-budgets-2026-03-13"],
)
```
You may need to experiment with different task budgets for your use case. If the model is given a task budget that is too restrictive for a given task, it may complete the task less thoroughly or refuse to do the task entirely.
For open-ended agentic tasks where quality matters more than speed, do not set a task budget; reserve task budgets for workloads where you need the model to scope its work to a token allowance. The minimum value for a task budget is 20k tokens.
This is not a hard cap; it's a suggestion that the model is aware of. This is distinct from `max_tokens`, which is a hard per-request cap on generated tokens (`max_tokens` is not passed to the model, and the model is not aware of it), while `task_budget` is an advisory cap across the full agentic loop. Use `task_budget` when you want the model to self-moderate, and `max_tokens` as a hard per-request ceiling to cap usage.
## Breaking changes
These breaking changes apply to the Messages API only. If you use Claude Managed Agents, there are no breaking API changes for Claude Opus 4.7.
### Extended thinking budgets removed
Extended thinking budgets are removed in Claude Opus 4.7. Setting `thinking: {"type": "enabled", "budget_tokens": N}` will return a 400 error. [Adaptive thinking](/docs/en/build-with-claude/adaptive-thinking) is the only thinking-on mode, and in our internal evaluations it reliably outperforms extended thinking.
```python Python
# Before (Opus 4.6)
thinking = {"type": "enabled", "budget_tokens": 32000}
# After (Opus 4.7)
thinking = {"type": "adaptive"}
output_config = {"effort": "high"}
```
Adaptive thinking is **off by default** on Claude Opus 4.7. Requests with no `thinking` field run without thinking. Set `thinking: {type: "adaptive"}` explicitly to enable it.
### Sampling parameters removed
Starting with Claude Opus 4.7, setting `temperature`, `top_p`, or `top_k` to any non-default value will return a 400 error. The safest migration path is to omit these parameters entirely from requests, and to use prompting to guide the model's behavior. If you were using `temperature = 0` for determinism, note that it never guaranteed identical outputs.
### Thinking content omitted by default
Starting with Claude Opus 4.7, thinking content is omitted from the response by default. Thinking blocks still appear in the response stream, but their `thinking` field will be empty unless the caller explicitly opts in. This is a silent change — no error is raised — and response latency will be slightly improved. If reasoning outputs are needed, you can set `display` to `"summarized"` and opt back in with a one-line change:
```python Python
thinking = {
"type": "adaptive",
"display": "summarized", # or "omitted" (default)
}
```
If your product streams reasoning to users, the new default will appear as a long pause before output begins. Set `"display": "summarized"` to restore visible progress during thinking.
### Updated token counting
Claude Opus 4.7 uses a new tokenizer, contributing to its improved performance on a wide range of tasks. This new tokenizer may use roughly 1x to 1.35x as many tokens when processing text compared to previous models (up to ~35% more, varying by content), and [`/v1/messages/count_tokens`](/docs/en/build-with-claude/token-counting) will return a different number of tokens for Claude Opus 4.7 than it did for Claude Opus 4.6. The token efficiency of Claude Opus 4.7 can vary by workload shape. Prompting interventions, `task_budget`, and `effort` can help control costs and ensure appropriate token usage. Keep in mind that these controls may trade off model intelligence.
We suggest updating your `max_tokens` parameters to give additional headroom, including compaction triggers. Claude Opus 4.7 provides a 1M context window at standard API pricing with no long-context premium.
## Capability improvements
### Knowledge work
Claude Opus 4.7 shows meaningful gains on knowledge-worker tasks, particularly where the model needs to visually verify its own outputs:
- **.docx redlining and .pptx editing** — improved at producing and self-checking tracked changes and slide layouts.
- **Charts and figure analysis** — improved at programmatic tool-calling with image-processing libraries (e.g. PIL) to analyze charts and figures, including pixel-level data transcription.
If existing prompts have mitigations in these areas (e.g. "double-check the slide layout before returning"), try removing that scaffolding and re-baselining.
### Memory
Claude Opus 4.7 is better at writing and using file-system-based memory. If an agent maintains a scratchpad, notes file, or structured memory store across turns, that agent should improve at jotting down notes to itself and leveraging its notes in future tasks. To give Claude a managed scratchpad without building your own, use the client-side [memory tool](/docs/en/agents-and-tools/tool-use/memory-tool).
### Vision
See [High-resolution image support](#high-resolution-image-support) above.
## Behavior changes
These are not API breaking changes but may require prompt updates. See [Migrating to Claude Opus 4.7](/docs/en/about-claude/models/migration-guide#migrating-to-claude-opus-4-7) for full guidance.
- **More literal instruction following**, particularly at lower effort levels. The model will not silently generalize an instruction from one item to another, and will not infer requests you didn't make.
- **Response length calibrates to perceived task complexity** rather than defaulting to a fixed verbosity.
- **Fewer tool calls by default,** using reasoning more. Raising effort increases tool usage.
- **More direct, opinionated tone** with less validation-forward phrasing and fewer emoji than Claude Opus 4.6's warmer style.
- **More regular progress updates** to the user throughout long agentic traces. If you've added scaffolding to force interim status messages, try removing it.
- **Fewer subagents spawned by default.** Steerable through prompting.
- **Real-time cybersecurity safeguards:** requests that involve prohibited or high-risk topics may lead to refusals. For legitimate security work, apply to the [Cyber Verification Program](https://claude.com/form/cyber-use-case).
## Migration guide
For step-by-step migration instructions and the full migration checklist, see [Migrating to Claude Opus 4.7](/docs/en/about-claude/models/migration-guide#migrating-to-claude-opus-4-7). If you use Claude Code or the Agent SDK, the [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill) can apply these migration steps to your codebase automatically.
## Next steps
Give Claude an advisory token budget across a full agentic loop.
The only supported thinking-on mode on Claude Opus 4.7.
Per-level effort guidance for Claude Opus 4.7.
High-resolution image support and 1\:1 coordinate mapping.
Step-by-step upgrade instructions.
---
## about-claude-models-whats-new-opus-5-855446aa29.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/about-claude/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Fwhats-new-opus-5)
SearchCtrlK
Models
[Models overview](/docs/en/about-claude/models/overview)[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Introducing Claude Fable 5 and Claude Mythos 5](/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5)[What's new in Claude Sonnet 5](/docs/en/about-claude/models/whats-new-sonnet-5)[What's new in Claude Opus 5](/docs/en/about-claude/models/whats-new-opus-5)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[System prompts](/docs/en/release-notes/system-prompts)[Pricing](/docs/en/about-claude/pricing)
[](/)
Console
[Models & pricing](/docs/en/about-claude/models/overview)Models
# What's new in Claude Opus 5
Copy page
Overview of new features and behavior changes in Claude Opus 5.
Copy page
Claude Opus 5 is a step-change improvement over Claude Opus 4.8, with the largest gains in deep reasoning, agentic and long-horizon tasks, and test-time compute scaling. This page summarizes everything new in Claude Opus 5, including thinking on by default, mid-conversation tool changes, and a breaking change to when thinking can be disabled.
New model
| Model | API model ID | Description |
|---------------|-----------------|------------------------------------------------|
| Claude Opus 5 | `claude-opus-5` | For complex agentic coding and enterprise work |
Claude Opus 5 has a [1M token context window](/docs/en/build-with-claude/context-windows) (1M tokens is both the default and the maximum; there is no smaller context variant), 128k max output tokens, and [thinking](/docs/en/build-with-claude/thinking) on by default.
For complete pricing and specs, see the [models overview](/docs/en/about-claude/models/overview).
New features
Mid-conversation tool changes (beta)
You can add or remove tools between turns of a conversation while preserving the prompt cache, instead of resending a fixed tool list for the life of a session. Mid-conversation tool changes are in beta: include the `mid-conversation-tool-changes-2026-07-01` beta header in your requests. See [Mid-conversation tool changes](/docs/en/build-with-claude/mid-conversation-system-messages#mid-conversation-tool-changes) for usage.
Default fallbacks mode
The `fallbacks` parameter supports a new `"default"` mode, which applies Anthropic's recommended fallback models by refusal category instead of a model list you maintain yourself. The entire `fallbacks` parameter is in beta. Use the `server-side-fallback-2026-07-01` beta header, which supports both the `"default"` mode and explicit model lists (the earlier `server-side-fallback-2026-06-01` header accepts only explicit lists). See [Refusals and fallback](/docs/en/build-with-claude/refusals-and-fallback).
Lower prompt cache minimum
The minimum cacheable prompt length on Claude Opus 5 is 512 tokens, down from 1,024 tokens on Claude Opus 4.8. Prompts that were too short to cache on Claude Opus 4.8 can now create cache entries with no code changes. See [Prompt caching](/docs/en/build-with-claude/prompt-caching#cache-limitations) for per-model minimums.
Fast mode
[Fast mode](/docs/en/build-with-claude/fast-mode) (research preview) is available for Claude Opus 5 on the Claude API only; it is not currently available on Amazon Bedrock, Google Cloud, or Microsoft Foundry. Fast mode for Claude Opus 5 is priced at \$10 USD per million input tokens and \$50 USD per million output tokens. See [Fast mode](/docs/en/build-with-claude/fast-mode) for access, supported models, and pricing.
Behavior changes
Thinking on by default
On Claude Opus 4.8, requests run without thinking unless you set `thinking: {"type": "adaptive"}`. On Claude Opus 5, the same requests run with [thinking](/docs/en/build-with-claude/thinking) on: the model decides when and how much to think on each turn, and the [effort parameter](/docs/en/build-with-claude/effort) is the control for thinking depth. The wire value is unchanged; `thinking: {"type": "adaptive"}` remains valid and equivalent to the default.
Because `max_tokens` is a hard limit on total output (thinking plus response text), revisit it for workloads that ran without thinking on Claude Opus 4.8.
The API keeps the option to disable thinking, subject to the effort restriction below.
Effort matters more
Claude Opus 5 converts additional [effort](/docs/en/build-with-claude/effort) into better results more reliably than any earlier Opus model, so the effort level you choose carries more weight. The full ladder is available: `low`, `medium`, `high`, `xhigh`, and `max`, with `max` as the top tier for the deepest possible reasoning. Start at the default, `high`, and adjust in either direction based on your evals: step down where quality holds to save tokens and latency, or step up for the most demanding work. When running at `xhigh` or `max` effort, set a large `max_tokens` so the model has room to think and act across subagents and tool calls.
This request turns effort all the way up to `max`:
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
client = anthropic.Anthropic()
with client.messages.stream(
model="claude-opus-5",
max_tokens=64000,
output_config={"effort": "max"},
messages=[
{
"role": "user",
"content": "Explain why the sum of two even numbers is always even.",
}
],
) as stream:
response = stream.get_final_message()
print(response)
```
Thinking is [on by default](#thinking-on-by-default) on Claude Opus 5, so no `thinking` field is needed.
Disabling thinking requires effort `high` or below
On Claude Opus 5, `thinking: {"type": "disabled"}` is accepted only when the effort level is `high` or below. Setting `thinking: {"type": "disabled"}` with effort `xhigh` or `max` returns a 400 error. This is generally available behavior on Claude Opus 5 onward, enforced on each request, and it is a breaking change from Claude Opus 4.8, where disabling thinking was independent of the effort level. If you disable thinking at high effort levels today, either keep thinking disabled and set effort to `high` or below, or keep the effort level and remove the `thinking` field.
With thinking disabled, Claude Opus 5 can occasionally write a tool call into its text output instead of emitting a `tool_use` block, or include internal XML tags in its visible response. Where possible, keep thinking enabled and control token cost with lower effort levels; for integrations that must keep thinking disabled, see [Running with thinking disabled](/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5#running-with-thinking-disabled) for prompting mitigations.
Model behavior differences
Beyond the API changes above, Claude Opus 5 behaves differently from Claude Opus 4.8 in ways you may notice without changing any code. Default user-facing responses and written deliverables run longer. In agentic sessions, the model narrates its progress to the user more often. In multi-agent frameworks, it delegates to subagents more readily. It also verifies its own work without being told to, so remove verification instructions carried over from earlier models ("include a final verification step," "use a subagent to verify"); they cause over-verification on Claude Opus 5. For prompting patterns that tune each of these behaviors, see [Prompting Claude Opus 5](/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5).
Capability improvements
Compared with Claude Opus 4.8, Claude Opus 5 is a step-change improvement rather than an incremental one, and it delivers frontier intelligence at half the cost of Claude Fable 5. The largest gains are in:
- **Deep reasoning**, sustaining multistep analysis across long problem chains.
- **Agentic coding and long-horizon tasks**, staying on task across extended tool-use loops and completing multi-file features, larger refactors, and end-to-end feature work without leaving stubs or placeholders.
- **Test-time compute scaling**, converting additional effort (up to the `max` level) into better results.
- **Efficiency at lower effort levels**, with `low` and `medium` [effort](/docs/en/build-with-claude/effort) producing strong quality at a fraction of the tokens and latency of higher settings.
- **Code review and bug-finding**, surfacing real bugs at a high rate per pass with few false positives, and staying accurate at lower effort levels.
- **Vision**, understanding charts, documents, and diagrams and replicating UI and frontend visuals, strongest when given tools to iteratively analyze, crop, and verify its work.
- **Long-context work**, with a [1M token context window](/docs/en/build-with-claude/context-windows) as both the default and the maximum, and consistent instruction following, tool calling, and reasoning throughout the window.
- **Office and document tasks**, generating and editing complex multi-sheet spreadsheets with non-trivial formulas, and producing well-structured slide decks.
- **Multi-agent coordination**, running teams of subagents with effective writer-verifier patterns and few cases of agents overwriting each other's work.
For the prompting patterns that get the most out of these capabilities, see [Prompting Claude Opus 5](/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5#capability-improvements).
Pricing
Claude Opus 5 is priced at \$5 USD per million input tokens and \$25 USD per million output tokens, unchanged from Claude Opus 4.8.
See [Pricing](/docs/en/about-claude/pricing) for complete pricing, including batch processing, prompt caching, and fast mode rates.
Availability
Claude Opus 5 is available on:
- **Claude API:** available to all customers, as `claude-opus-5`.
- **AWS:** available through [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock), as `anthropic.claude-opus-5`. Claude Opus 5 is also reachable through the `InvokeModel` API on `bedrock-runtime`, served by the same infrastructure; the [Claude on Amazon Bedrock (legacy)](/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) integration does not include it in its ARN-versioned model ID table.
- **Google Cloud:** available through [Claude on Google Cloud](/docs/en/build-with-claude/claude-on-vertex-ai), as `claude-opus-5`.
- **Microsoft Foundry:** available through [Claude in Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry).
Claude Opus 4.8 remains available on all of these platforms.
Migration guide
To migrate from Claude Opus 4.8, update your model ID:
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
model = "claude-opus-4-8" # Before
model = "claude-opus-5" # After
```
Then review the two [behavior changes](#behavior-changes): thinking is on by default, and disabling thinking with effort `xhigh` or `max` returns a 400 error. See the [migration guide](/docs/en/about-claude/models/migration-guide#migrating-from-claude-opus-4-8-to-claude-opus-5) for step-by-step instructions.
Next steps
[Models overview](/docs/en/about-claude/models/overview)
Complete specs and pricing for all current Claude models.
[Prompting Claude Opus 5](/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5)
Behavioral differences and prompting patterns specific to Claude Opus 5.
[Effort](/docs/en/build-with-claude/effort)
Control how many tokens Claude uses when responding, from low to max.
[Thinking](/docs/en/build-with-claude/thinking)
How thinking works when it's on by default, and when it can be disabled.
[Task budgets](/docs/en/build-with-claude/task-budgets)
Give Claude an advisory token budget to pace its work against.
[Migration guide](/docs/en/about-claude/models/migration-guide)
Guide for migrating to the latest Claude models from previous Claude versions.
[Fast mode](/docs/en/build-with-claude/fast-mode)
Get higher output tokens per second from Claude Opus models at premium pricing.
---
## about-claude-models-whats-new-sonnet-5-d31213b17d.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/about-claude/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fabout-claude%2Fmodels%2Fwhats-new-sonnet-5)
SearchCtrlK
Models
[Models overview](/docs/en/about-claude/models/overview)[Model IDs and versioning](/docs/en/about-claude/models/model-ids-and-versions)[Choosing a model](/docs/en/about-claude/models/choosing-a-model)[Optimizing for cost and intelligence](/docs/en/about-claude/models/optimizing-for-cost-and-intelligence)[Introducing Claude Fable 5 and Claude Mythos 5](/docs/en/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5)[What's new in Claude Sonnet 5](/docs/en/about-claude/models/whats-new-sonnet-5)[What's new in Claude Opus 5](/docs/en/about-claude/models/whats-new-opus-5)[Upgrade between model versions](/docs/en/about-claude/models/migration-guide)[Model deprecations](/docs/en/about-claude/model-deprecations)[Model cards](/docs/en/resources/overview)[System prompts](/docs/en/release-notes/system-prompts)[Pricing](/docs/en/about-claude/pricing)
[](/)
Console
[Models & pricing](/docs/en/about-claude/models/overview)Models
# What's new in Claude Sonnet 5
Copy page
Overview of new features and behavior changes in Claude Sonnet 5.
Copy page
Claude Sonnet 5 is the next generation of Anthropic's Sonnet model family. It is a drop-in upgrade for Claude Sonnet 4.6 with three behavior changes: [adaptive thinking](/docs/en/build-with-claude/thinking) is on by default, manual extended thinking now returns a 400 error (it was deprecated on Claude Sonnet 4.6), and setting sampling parameters (`temperature`, `top_p`, `top_k`) to non-default values returns a 400 error. This page summarizes everything new at launch, including a new tokenizer.
New model
| Model | API model ID | Description |
|-----------------|-------------------|------------------------------------------------|
| Claude Sonnet 5 | `claude-sonnet-5` | The best combination of speed and intelligence |
Claude Sonnet 5 supports the [1M token context window](/docs/en/build-with-claude/context-windows) by default (1M tokens is both the default and the maximum; there is no smaller context variant), 128k max output tokens, [adaptive thinking](/docs/en/build-with-claude/thinking), and the same set of tools and platform features as Claude Sonnet 4.6, except [Priority Tier](/docs/en/api/service-tiers#supported-models), which is not available on Claude Sonnet 5.
For complete pricing and specs, see the [models overview](/docs/en/about-claude/models/overview).
Behavior changes
Adaptive thinking on by default
On Claude Sonnet 4.6, requests without a `thinking` field run without thinking. On Claude Sonnet 5, the same requests run with [adaptive thinking](/docs/en/build-with-claude/thinking). To turn thinking off, pass `thinking: {type: "disabled"}`. Because `max_tokens` is a hard limit on total output (thinking plus response text), revisit it for workloads that ran without thinking on Claude Sonnet 4.6.
Sampling parameters not accepted
Setting `temperature`, `top_p`, or `top_k` to a non-default value returns a 400 error. Remove these parameters when migrating; the default value (or omitting the parameter) is accepted. Use system-prompt instructions to guide model behavior. This is new for Sonnet-class models; the same constraint was previously introduced on Claude Opus 4.7.
Manual extended thinking removed
Manual extended thinking (`thinking: {type: "enabled", budget_tokens: N}`) was deprecated on Claude Sonnet 4.6; on Claude Sonnet 5 it is removed and returns a 400 error, the same as on Claude Opus 4.8 and Claude Opus 4.7. Use adaptive thinking with the [effort parameter](/docs/en/build-with-claude/effort) instead.
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
# Not supported on Claude Sonnet 5 (returns 400)
thinking = {"type": "enabled", "budget_tokens": 32000}
# Use this instead
thinking = {"type": "adaptive"}
```
New tokenizer
Claude Sonnet 5 uses a new tokenizer. The same input text produces approximately 30% more tokens than on Claude Sonnet 4.6. The exact increase depends on the content. This is not an API change: requests, responses, and streaming events keep the same shape, and no code changes are required.
The change affects anything you measure or budget in tokens:
- **Token counts:** `usage` fields and [token counting](/docs/en/build-with-claude/token-counting) results for the same text are higher than on Claude Sonnet 4.6. Don't reuse counts measured against earlier models; recount against Claude Sonnet 5.
- **Context window capacity in text terms:** the context window is 1M tokens, but each token covers less text on average, so the same window holds less text than on Claude Sonnet 4.6.
- **`max_tokens` budgets:** an output limit tuned for Claude Sonnet 4.6 may truncate equivalent output on Claude Sonnet 5. Revisit limits sized close to your expected output length.
- **Per-request cost:** per-token pricing is lower than Claude Sonnet 4.6's (see [Pricing](#pricing)), but because the same text produces more tokens, the cost of an equivalent request does not drop in direct proportion.
API constraints inherited from Claude Sonnet 4.6
This constraint is unchanged from Claude Sonnet 4.6. Aside from the three [behavior changes](#behavior-changes) (see [Migration guide](#migration-guide)), code that already runs on Claude Sonnet 4.6 needs no other changes.
Assistant message prefilling not supported
Prefilling the assistant message returns a `400` error, unchanged from Claude Sonnet 4.6. Use [structured outputs](/docs/en/build-with-claude/structured-outputs), system prompt instructions, or `output_config.format` instead.
Capability improvements
Claude Sonnet 5 is a capability upgrade over Claude Sonnet 4.6 at a lower price. It is also an option for workloads that need more capability than Claude Sonnet 4.6 provides without moving to an Opus-class model.
The largest gains over Claude Sonnet 4.6 are in coding and agentic tasks. For benchmark results, see [Anthropic's Transparency Hub](https://www.anthropic.com/transparency).
Cybersecurity safeguards
Claude Sonnet 5 is the first Sonnet-tier model with real-time cybersecurity safeguards. Requests that involve prohibited or high-risk cybersecurity topics may be refused. Refusals return as a successful HTTP 200 response with `stop_reason: "refusal"`, not an error. See [Safeguards, warnings, and appeals](https://support.claude.com/en/articles/8241253-safeguards-warnings-and-appeals) for background.
Pricing
Claude Sonnet 5 is priced at \$2 per million input tokens and \$10 per million output tokens, lower per-token pricing than Claude Sonnet 4.6's \$3/\$15. Because the [new tokenizer](#new-tokenizer) produces approximately 30% more tokens for the same text, the cost of an equivalent request does not drop in direct proportion to the per-token prices when comparing with Claude Sonnet 4.6. The exact difference depends on the content and workload shape.
See [Pricing](/docs/en/about-claude/pricing) for complete pricing, including batch processing and prompt caching rates.
Availability
At launch, Claude Sonnet 5 is available on:
- **Claude API:** available to all customers.
- **AWS:** available through [Claude in Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock) and [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws). On Amazon Bedrock, Claude Sonnet 5 is also reachable through the `InvokeModel` API, served by the same infrastructure as Claude in Amazon Bedrock. The legacy [Claude on Amazon Bedrock (Opus 4.6 and earlier)](/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy) integration does not include Claude Sonnet 5.
- **Google Cloud:** available through [Claude on Google Cloud](/docs/en/build-with-claude/claude-on-vertex-ai).
- **Microsoft Foundry:** available through [Claude in Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry).
Claude Sonnet 5 supports [zero data retention](/docs/en/manage-claude/api-and-data-retention) for organizations with ZDR agreements.
Migration guide
Claude Sonnet 5 is a drop-in replacement for Claude Sonnet 4.6. Update your model ID:
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
model = "claude-sonnet-4-6" # Before
model = "claude-sonnet-5" # After
```
Then review the following:
1. **Token budgets and counts:** the [new tokenizer](#new-tokenizer) produces approximately 30% more tokens for the same text. The exact increase depends on the content and workload shape. Recount prompts with [token counting](/docs/en/build-with-claude/token-counting), and revisit `max_tokens` limits sized close to your expected output length.
2. **Extended thinking:** if you still set `budget_tokens`, migrate to [adaptive thinking](/docs/en/build-with-claude/thinking). Manual extended thinking (`thinking: {type: "enabled"}`) is not supported and returns a 400 error.
3. **Sampling parameters:** requests that set sampling parameters (`temperature`, `top_p`, `top_k`) to a non-default value return a 400 error; remove them when migrating. Tool definitions and response shapes are unchanged, and assistant message prefilling was already unsupported on Claude Sonnet 4.6.
See the [Claude Sonnet 5 section of the migration guide](/docs/en/about-claude/models/migration-guide#migrating-from-claude-sonnet-4-6-to-claude-sonnet-5) for details.
Next steps
[Models overview](/docs/en/about-claude/models/overview)
Complete specs and pricing for all current Claude models.
[Token counting](/docs/en/build-with-claude/token-counting)
Measure your prompts under the new tokenizer before you migrate.
[Adaptive thinking](/docs/en/build-with-claude/thinking)
The recommended thinking-on mode on Claude Sonnet 5.
[Context windows](/docs/en/build-with-claude/context-windows)
How the 1M token context window works.
[Pricing](/docs/en/about-claude/pricing)
Complete pricing, including batch processing and prompt caching rates.
---
## adapt-to-new-model-personas-after-deprecations-e76aacc6b0.md
# Adapt to new model personas after deprecations
July 10, 2026
Copy for LLM
**[Model deprecations and retirements](https://docs.claude.com/en/docs/about-claude/model-deprecations#model-status)** are routine parts of the model lifecycle. While we would like to keep past models publicly available as we continue to advance the frontier of safety and capabilities, maintenance overhead and capacity constraints do not currently allow this. We nonetheless recognize that losing access to models comes with costs to many users, particularly those who have come to value the unique character or capabilities of a specific model on a personal level. We aim to provide resources, tools, and guidance to such users to minimize these costs and make the transitions between models as smooth and seamless as possible.
## Strategies and recommendations
Below are a set of strategies and recommendations for adapting to model transitions. Not all of them will be applicable in every circumstance, but in most cases we expect that some combination of these strategies can help to smooth the transition between models. We encourage you to experiment with these and other strategies to find what works best for you.
- When a model deprecation is announced, we suggest experimenting with newer models as soon as possible. You can test different models and run side-by-side comparisons with the kinds of prompts and conversations that matter the most to you, to identify the best alternative model prior to retirement.
- **[Enabling memory and allowing Claude to search past chats](https://support.claude.com/en/articles/11817273-using-claude-s-chat-search-and-memory-to-build-on-previous-context)** can help new models to learn and immediately adapt to your preferences and communication style.
- **[Projects](https://support.claude.com/en/articles/9519177-how-can-i-create-and-manage-projects)** offer another means of personalization, and can include custom instructions for Claude as well as custom context, which again can help new models understand and adapt to your needs and preferences.
- Using these personalization strategies can be thought of as giving feedback to new models. If you find that a new model is more or less talkative than you’d prefer, or has a different tone, you can shape the model’s behavior within a conversation, within a project, or across your entire account using the strategies above. If you’re not sure how to describe the qualities you’re looking for, you can ask Claude to review some of the conversations you’ve most appreciated and to craft instructions for itself based on those.
- In addition to finding strategies for preserving features and styles of past models, we also encourage you to explore the changes that newer models bring. They often offer improved performance on complex topics, improved brainstorming and collaboration, better instruction following, and other improvements that you may find valuable, even if they come with a change.
- Along with these practical strategies, we recommend maintaining a general awareness of the model lifecycle when relating to models; historically Anthropic has deprecated most models around a year after their initial release.
These strategies aren’t perfect and can only go so far toward preserving or replicating the unique experience of interacting with a particular model, which we recognize is intrinsically important to many users. We’re taking **[other early steps](https://www.anthropic.com/research/deprecation-commitments)** toward ensuring model preservation post-retirement, and someday aim to make past models publicly available again in some form.
---
## adapting-to-new-model-personas-after-deprecations-24851bca6e.md
# Adapt to new model personas after deprecations
July 10, 2026
Copy for LLM
**[Model deprecations and retirements](https://docs.claude.com/en/docs/about-claude/model-deprecations#model-status)** are routine parts of the model lifecycle. While we would like to keep past models publicly available as we continue to advance the frontier of safety and capabilities, maintenance overhead and capacity constraints do not currently allow this. We nonetheless recognize that losing access to models comes with costs to many users, particularly those who have come to value the unique character or capabilities of a specific model on a personal level. We aim to provide resources, tools, and guidance to such users to minimize these costs and make the transitions between models as smooth and seamless as possible.
## Strategies and recommendations
Below are a set of strategies and recommendations for adapting to model transitions. Not all of them will be applicable in every circumstance, but in most cases we expect that some combination of these strategies can help to smooth the transition between models. We encourage you to experiment with these and other strategies to find what works best for you.
- When a model deprecation is announced, we suggest experimenting with newer models as soon as possible. You can test different models and run side-by-side comparisons with the kinds of prompts and conversations that matter the most to you, to identify the best alternative model prior to retirement.
- **[Enabling memory and allowing Claude to search past chats](https://support.claude.com/en/articles/11817273-using-claude-s-chat-search-and-memory-to-build-on-previous-context)** can help new models to learn and immediately adapt to your preferences and communication style.
- **[Projects](https://support.claude.com/en/articles/9519177-how-can-i-create-and-manage-projects)** offer another means of personalization, and can include custom instructions for Claude as well as custom context, which again can help new models understand and adapt to your needs and preferences.
- Using these personalization strategies can be thought of as giving feedback to new models. If you find that a new model is more or less talkative than you’d prefer, or has a different tone, you can shape the model’s behavior within a conversation, within a project, or across your entire account using the strategies above. If you’re not sure how to describe the qualities you’re looking for, you can ask Claude to review some of the conversations you’ve most appreciated and to craft instructions for itself based on those.
- In addition to finding strategies for preserving features and styles of past models, we also encourage you to explore the changes that newer models bring. They often offer improved performance on complex topics, improved brainstorming and collaboration, better instruction following, and other improvements that you may find valuable, even if they come with a change.
- Along with these practical strategies, we recommend maintaining a general awareness of the model lifecycle when relating to models; historically Anthropic has deprecated most models around a year after their initial release.
These strategies aren’t perfect and can only go so far toward preserving or replicating the unique experience of interacting with a particular model, which we recognize is intrinsically important to many users. We’re taking **[other early steps](https://www.anthropic.com/research/deprecation-commitments)** toward ensuring model preservation post-retirement, and someday aim to make past models publicly available again in some form.
---
## adapting-to-new-model-personas-after-deprecations.md
4. Adapting to new model personas after deprecations
# Adapting to new model personas after deprecations
[Model deprecations and retirements](https://docs.claude.com/en/docs/about-claude/model-deprecations#model-status) are routine parts of the model lifecycle. While we would like to keep past models publicly available as we continue to advance the frontier of safety and capabilities, maintenance overhead and capacity constraints do not currently allow this. We nonetheless recognize that losing access to models comes with costs to many users, particularly those who have come to value the unique character or capabilities of a specific model on a personal level. We aim to provide resources, tools, and guidance to such users to minimize these costs and make the transitions between models as smooth and seamless as possible.
## Strategies and recommendations
Below are a set of strategies and recommendations for adapting to model transitions. Not all of them will be applicable in every circumstance, but in most cases we expect that some combination of these strategies can help to smooth the transition between models. We encourage you to experiment with these and other strategies to find what works best for you.
- When a model deprecation is announced, we suggest experimenting with newer models as soon as possible. You can test different models and run side-by-side comparisons with the kinds of prompts and conversations that matter the most to you, to identify the best alternative model prior to retirement.
- [Enabling memory and allowing Claude to search past chats](https://support.claude.com/en/articles/11817273-using-claude-s-chat-search-and-memory-to-build-on-previous-context) can help new models to learn and immediately adapt to your preferences and communication style.
- [Defining custom styles](https://support.claude.com/en/articles/10181068-configuring-and-using-styles) that capture your preferred communication style can help improve consistency between models.
- [Projects](https://support.claude.com/en/articles/9519177-how-can-i-create-and-manage-projects) offer another means of personalization, and can include custom instructions for Claude as well as custom context, which again can help new models understand and adapt to your needs and preferences.
- Using these personalization strategies can be thought of giving feedback to new models. If you find that a new model is more or less talkative than you’d prefer, or has a different tone, you can shape the model’s behavior within a conversation, within a project, or across your entire account using the strategies above. If you’re not sure how to describe the qualities you’re looking for, you can ask Claude to review some of the conversations you’ve most appreciated and to craft instructions for itself based on those.
- In addition to finding strategies for preserving features and styles of past models, we also encourage you to explore the changes that newer models bring. They often offer improved performance on complex topics, improved brainstorming and collaboration, better instruction following, and other improvements that you may find valuable, even if they come with a change.
- Along with these practical strategies, we recommend maintaining a general awareness of the model lifecycle when relating to models; historically Anthropic has deprecated most models around a year after their initial release.
These strategies aren’t perfect and can only go so far toward preserving or replicating the unique experience of interacting with a particular model, which we recognize is intrinsically important to many users. We’re taking [other early steps](../19-Reference/commitments-on-model-deprecation-and-preservation-anthropic.md) toward ensuring model preservation post-retirement, and someday aim to make past models publicly available again in some form.
---
## agents-and-tools-agent-skills-claude-api-skill-195bd9fb41.md
# Claude API skill
An open-source Agent Skill that provides Claude with up-to-date API reference material, SDK documentation, and best practices for building applications with the Claude API and Claude Managed Agents.
---
The `claude-api` skill is an open-source [Agent Skill](/docs/en/agents-and-tools/agent-skills/overview) that provides Claude with detailed, up-to-date reference material for building applications on two Anthropic surfaces:
- **Messages API** — the primary surface for single requests, streaming chat, tool use, batch processing, prompt caching, structured outputs, and custom agent loops.
- **Claude Managed Agents (beta)** — a first-party surface for server-managed stateful agents with Anthropic-hosted tool execution, persistent agent configs, and per-session containers.
It covers 8 programming languages for the Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP, and cURL) and 7 languages for Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP, and cURL — C# is not currently supported).
The skill comes bundled with [Claude Code](../02-Claude-Code-CLI/claude-code-overview-claude-code-docs-c23f3e7cbb.md) and is also available in the open-source [Anthropic skills repository](https://github.com/anthropics/skills/tree/main/skills/claude-api), where you can install it in any environment that supports Agent Skills.
The skill uses [progressive disclosure](/docs/en/agents-and-tools/agent-skills/overview#three-types-of-skill-content-three-levels-of-loading) to keep context efficient: Claude loads only the documentation relevant to your project's language, surface (Messages API or Managed Agents), and the specific task at hand (tool use, streaming, batches, and so on), rather than loading everything at once.
## What the skill provides
When triggered, the skill equips Claude with:
**For the Messages API:**
- **Language-specific SDK documentation:** Installation, quick start, common patterns, and error handling for your project's language
- **Tool use guidance:** Language-specific examples and [conceptual foundations](/docs/en/agents-and-tools/tool-use/overview) for function calling, including the beta tool runner where available
- **Streaming patterns:** Implementation details for building chat UIs and handling incremental display
- **Batch processing:** Offline batch processing at 50% cost
- **Prompt caching:** Prefix-stability design, breakpoint placement, and silent-invalidator audit
- **Model migration:** Step-by-step guidance for migrating to newer Claude models (including the breaking changes and behavior shifts on [Claude Opus 4.7](/docs/en/about-claude/models/migration-guide#migrating-to-claude-opus-4-7))
- **Current model information:** Model IDs, context window sizes, and pricing
- **Common pitfalls:** Detailed guidance on avoiding frequent mistakes when integrating with the API
**For Managed Agents (beta):**
- **Onboarding flow:** An interview-driven walkthrough for setting up a new Managed Agent from scratch, available via the `/claude-api managed-agents-onboard` subcommand
- **Language-specific Managed Agents docs:** Creating persistent agents, starting sessions, streaming events, and handling tool confirmations for Python, TypeScript, Java, Go, Ruby, PHP, and cURL
- **Client patterns:** Lossless stream reconnect, `processed_at` queued/processed gate, interrupt handling, file-mount gotchas, and credential handling
- **Deployment constraints:** Managed Agents is first-party only (not available on Amazon Bedrock, Google Vertex AI, or Microsoft Foundry) — the skill routes third-party deployments to Messages API + tool use instead
## When the skill activates
The skill activates in two ways:
**Automatic activation** occurs when:
- Your code imports an Anthropic SDK (`anthropic` for Python, `@anthropic-ai/sdk` for TypeScript/JavaScript)
- You ask Claude to help build, debug, or optimize something with the Claude API, an Anthropic SDK, or Managed Agents
- You add, modify, or tune a Claude feature in a file (prompt caching, adaptive thinking, compaction, tool use, batch, files, citations, memory) or a model reference
**Manual invocation** by typing `/claude-api` (with optional subcommand or prose) in any environment where the skill is installed.
The skill does not activate for general programming tasks, ML/data-science work, or code that imports other AI SDKs (such as OpenAI).
## Supported languages
The skill detects your project's language automatically by examining project files (for example, `requirements.txt` for Python, `tsconfig.json` for TypeScript, `go.mod` for Go) and loads the appropriate documentation.
| Language | Messages API SDK | Tool runner | Managed Agents |
|------------|------------------|-------------|----------------|
| Python | Yes | Yes (beta) | Yes (beta) |
| TypeScript | Yes | Yes (beta) | Yes (beta) |
| Java | Yes | No | Yes (beta) |
| Go | Yes | No | Yes (beta) |
| Ruby | Yes | Yes (beta) | Yes (beta) |
| C# | Yes | No | No |
| PHP | Yes | No | Yes (beta) |
| cURL | Yes | N/A | Yes (beta) |
If your project uses multiple languages, Claude asks which one applies. For unsupported languages (Rust, Swift, C++), the skill provides cURL/raw HTTP examples.
## How to use the skill
### In Claude Code (bundled)
The skill ships with [Claude Code](../02-Claude-Code-CLI/claude-code-overview-claude-code-docs-c23f3e7cbb.md) and requires no installation. When you ask Claude to help build something with the Claude API, or when your project already imports an Anthropic SDK, the skill activates automatically.
You can also invoke it directly:
```text
/claude-api
```
For more about how bundled skills work in Claude Code, see the [Claude Code skills documentation](../08-Plugins-Skills/extend-claude-with-skills-claude-code-docs.md#bundled-skills).
### From the skills repository
The skill source is available in the [Anthropic skills repository](https://github.com/anthropics/skills). You can install it using the `npx` command:
```bash
npx skills add https://github.com/anthropics/skills --skill claude-api
```
Or install it as a Claude Code [plugin](../08-Plugins-Skills/create-plugins-claude-code-docs.md):
```bash
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills
```
## Migrating to a newer Claude model
The Claude API skill can perform Claude model migrations across a codebase. Invoke it directly with `/claude-api migrate`:
```text
/claude-api migrate this project to claude-opus-4-7
```
You can also pass a specific scope up front to skip the scope-confirmation question:
```text
/claude-api migrate everything under src/ to claude-opus-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7
```
When the scope is ambiguous (for example, a bare `/claude-api migrate to claude-opus-4-7`), the skill asks you to choose between the entire working directory, a specific subdirectory, or an explicit file list before editing any files. This applies to both Messages API and Managed Agents callers.
The skill handles:
- **Model ID swaps**, including typed SDK constants (`Model.CLAUDE_OPUS_4_6` → `Model.CLAUDE_OPUS_4_7`) across all supported languages, and classifies each file as a caller, a model definer, or an opaque string reference before editing
- **Breaking parameter changes**, such as removing `temperature`, `top_p`, and `top_k` for Claude Opus 4.7, and converting `thinking: {type: "enabled", budget_tokens: N}` to `thinking: {type: "adaptive"}`
- **Prefill replacement**, converting assistant-message prefill patterns to [structured outputs](/docs/en/build-with-claude/structured-outputs) where applicable
- **Beta header cleanup**, removing headers that are GA on the target model (for example, `effort-2025-11-24`, `fine-grained-tool-streaming-2025-05-14`, `interleaved-thinking-2025-05-14`) and switching back from `client.beta.messages.create` to `client.messages.create`
- **Effort calibration**, recommending an `output_config.effort` starting point for the target model (for example, `xhigh` for coding and agentic use cases on Claude Opus 4.7)
- **Prompt-behavior tuning**, flagging length-control, tool-triggering, subagent, and instruction-following prompts that may behave differently on the target model
- **Silent default handling**, opting back into thinking summarization (`thinking.display: "summarized"`) when reasoning is surfaced to users on Claude Opus 4.7
As it edits, the skill explains each change and its motivation inline. On completion, it produces a checklist of items that require manual verification (typically integration tests, length-control prompt tuning, and cost/rate-limit re-baselining).
For the full list of model-specific changes the skill applies, see [Migrating to Claude Opus 4.7](/docs/en/about-claude/models/migration-guide#migrating-to-claude-opus-4-7).
## Setting up a Managed Agent
To scaffold a new Managed Agent from scratch, invoke the `managed-agents-onboard` subcommand:
```text
/claude-api managed-agents-onboard
```
The skill runs an interview that walks you through the Managed Agents mental model (Agent configs versus Sessions), templates an agent config, configures environments and tools, sets up the session loop, and emits runnable code for your language. The skill also covers the mandatory **Agent (once) → Session (every run)** flow — `model`, `system`, and `tools` live on the agent, never on the session, and agents should be created once and referenced by ID.
Managed Agents requires the `managed-agents-2026-04-01` beta header, which the SDK sets automatically for all `client.beta.agents.*`, `client.beta.environments.*`, `client.beta.sessions.*`, and `client.beta.vaults.*` calls.
## Example usage
Here are examples of tasks the skill helps Claude handle:
**Building a chat application:**
```text
Build a streaming chat UI with the Claude API in TypeScript
```
**Migrating an existing project:**
```text
/claude-api migrate this codebase to claude-opus-4-7 and re-tune effort
```
**Onboarding a new Managed Agent:**
```text
/claude-api managed-agents-onboard
```
In each case, the skill loads the relevant language-specific documentation and guides Claude through the implementation using current API patterns and best practices.
## Next steps
Learn about how Agent Skills work and the progressive disclosure model
Browse the official Anthropic SDKs for all supported languages
Explore the public Anthropic skills repository on GitHub
---
## agents-and-tools-agent-skills-claude-api-skill-a5f702dd17.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fagents-and-tools%2Fagent-skills%2Fclaude-api-skill)
SearchCtrlK
Claude API skill
[Overview](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
[Console](/)
Claude API skill
# Claude API skill
Copy page
An open-source Agent Skill that provides Claude with up-to-date API reference material, SDK documentation, and best practices for building applications with the Claude API and Claude Managed Agents.
Copy page
The `claude-api` skill is an open-source [Agent Skill](/docs/en/agents-and-tools/agent-skills/overview) that provides Claude with detailed, up-to-date reference material for building applications on two Anthropic surfaces:
- **Messages API:** The primary surface for single requests, streaming chat, tool use, batch processing, prompt caching, structured outputs, and custom agent loops.
- **Claude Managed Agents (beta):** An Anthropic-hosted surface for server-managed stateful agents with Anthropic-hosted tool execution, persistent agent configs, and per-session sandboxes.
It covers eight programming languages for both the Messages API and Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby, and cURL.
The skill comes bundled with [Claude Code](https://code.claude.com/docs/en/overview) and is also available in the open-source [Anthropic skills repository](https://github.com/anthropics/skills), where you can install it in any environment that supports Agent Skills.
The skill uses [progressive disclosure](/docs/en/agents-and-tools/agent-skills/overview#how-skills-work) to keep context efficient: Claude loads only the documentation relevant to your project's language, surface (Messages API or Managed Agents), and the specific task at hand (tool use, streaming, batches, and so on), rather than loading everything at once.
## What the skill provides
When triggered, the skill equips Claude with:
**For the Messages API:**
- **Language-specific SDK documentation:** Installation, quick start, common patterns, and error handling for your project's language
- **Tool use guidance:** Language-specific examples and [conceptual foundations](/docs/en/agents-and-tools/tool-use/overview) for function calling, including the beta tool runner where available
- **Streaming patterns:** Implementation details for building chat UIs and handling incremental display
- **Batch processing:** Offline batch processing at 50% cost
- **Prompt caching:** Prefix-stability design, breakpoint placement, and silent-invalidator audit
- **Model migration:** Step-by-step guidance for migrating to newer Claude models (including the breaking changes and behavior shifts on [Claude Opus 5.5](/docs/en/models/opus-5-5/migration-guide#migrating-from-claude-opus-5) and [Claude Fable 5.1](/docs/en/models/fable-5-1/migration-guide))
- **Current model information:** Model IDs, context window sizes, and pricing
- **Common pitfalls:** Detailed guidance on avoiding frequent mistakes when integrating with the API
**For Managed Agents (beta):**
- **Onboarding flow:** An interview-driven walkthrough for setting up a new Managed Agent from scratch, available through the `/claude-api managed-agents-onboard` subcommand
- **Language-specific Managed Agents docs:** Creating persistent agents, starting sessions, streaming events, and handling tool confirmations for Python, TypeScript, C#, Go, Java, PHP, Ruby, and cURL
- **Client patterns:** Lossless stream reconnect, `processed_at` queued/processed gate, interrupt handling, file-mount gotchas, and credential handling
- **Deployment constraints:** Managed Agents is available on the Claude API and [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws) only (not on Amazon Bedrock, Google Cloud, or Microsoft Foundry). The skill routes other deployments to the Messages API and tool use instead.
## When the skill activates
The skill activates in two ways:
**Automatic activation** occurs when:
- Your code imports an Anthropic SDK (`anthropic` for Python, `@anthropic-ai/sdk` for TypeScript/JavaScript)
- You ask Claude to help build, debug, or optimize something with the Claude API, an Anthropic SDK, or Managed Agents
- You add, modify, or tune a Claude feature in a file (prompt caching, adaptive thinking, compaction, tool use, batch, files, citations, memory) or a model reference
**Manual invocation** by typing `/claude-api` (with optional subcommand or prose) in any environment where the skill is installed.
The skill does not activate for general programming tasks, ML/data-science work, or code that imports other AI SDKs (such as OpenAI).
## Supported languages
The skill detects your project's language automatically by examining project files (for example, `requirements.txt` for Python, `tsconfig.json` for TypeScript, `go.mod` for Go) and loads the appropriate documentation.
| Language | Messages API SDK | Tool runner | Managed Agents |
|------------|------------------|-------------|----------------|
| Python | Yes | Yes (beta) | Yes (beta) |
| TypeScript | Yes | Yes (beta) | Yes (beta) |
| C# | Yes | Yes (beta) | Yes (beta) |
| Go | Yes | Yes (beta) | Yes (beta) |
| Java | Yes | Yes (beta) | Yes (beta) |
| PHP | Yes | Yes (beta) | Yes (beta) |
| Ruby | Yes | Yes (beta) | Yes (beta) |
| cURL | Yes | N/A | Yes (beta) |
If your project uses multiple languages, Claude asks which one applies. For unsupported languages (Rust, Swift, C++), the skill provides cURL/raw HTTP examples.
## How to use the skill
### In Claude Code (bundled)
The skill ships with [Claude Code](https://code.claude.com/docs/en/overview) and requires no installation. When you ask Claude to help build something with the Claude API, or when your project already imports an Anthropic SDK, the skill activates automatically.
You can also invoke it directly:
``` block
/claude-api
```
For more about how bundled skills work in Claude Code, see the [Claude Code skills documentation](https://code.claude.com/docs/en/skills#bundled-skills).
### From the skills repository
The skill source is available in the [Anthropic skills repository](https://github.com/anthropics/skills). You can install it using the `npx` command:
```python
npx skills add https://github.com/anthropics/skills --skill claude-api
```
Or install it as a [Claude Code plugin](https://code.claude.com/docs/en/plugins):
``` block
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills
```
## Migrating to a newer Claude model
The Claude API skill can perform Claude model migrations across a code base. Invoke it directly with `/claude-api migrate`:
```python
/claude-api migrate this project to claude-opus-5-5
```
You can also pass a specific scope up front to skip the scope-confirmation question:
```python
/claude-api migrate everything under src/ to claude-opus-5-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5-5
```
When the scope is ambiguous (for example, a bare `/claude-api migrate to claude-opus-5-5`), the skill asks you to choose between the entire working directory, a specific subdirectory, or an explicit file list before editing any files. This applies to both Messages API and Managed Agents callers.
The skill handles:
- **Model ID swaps**, including typed SDK constants (`Model.CLAUDE_OPUS_4_8` → `Model.CLAUDE_OPUS_5_5`) across all supported languages, and classifies each file as a caller, a model definer, or an opaque string reference before editing
- **Cloud platform detection**, preserving platform-specific model ID formats (for example, the `anthropic.` prefix on Amazon Bedrock) and skipping changes for features that are unavailable on partner-operated platforms
- **Breaking parameter changes**, such as removing `temperature`, `top_p`, and `top_k` for Claude Opus 4.8 and Claude Opus 4.7, and converting `thinking: {type: "enabled", budget_tokens: N}` to `thinking: {type: "adaptive"}`
- **Prefill replacement**, converting assistant-message prefill patterns to [structured outputs](/docs/en/build-with-claude/structured-outputs) where applicable
- **Beta header cleanup**, removing beta headers that the target model doesn't require (for example, `effort-2025-11-24`, `fine-grained-tool-streaming-2025-05-14`, `interleaved-thinking-2025-05-14`) and switching back from `client.beta.messages.create` to `client.messages.create`
- **Effort calibration**, recommending an `output_config.effort` starting point for the target model (for example, the default `high` on Claude Opus 5, and `xhigh` for coding and agentic use cases on Claude Opus 4.8 and Claude Opus 4.7)
- **Prompt-behavior tuning**, flagging length-control, tool-triggering, subagent, and instruction-following prompts that may behave differently on the target model
- **Silent default handling**, opting back into thinking summarization (`thinking.display: "summarized"`) when reasoning is surfaced to users on Claude Opus 4.8 and Claude Opus 4.7
- **Refusal fallback configuration**, adding `stop_reason: "refusal"` handling before reading response content and setting up a [fallback retry path](/docs/en/build-with-claude/refusals-and-fallback) when the target is Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, or Claude Opus 5 (the server-side `fallbacks` parameter, typically in its `"default"` mode, the SDK refusal-fallback middleware, or a fallback-credit retry), and updating fallback code written against earlier preview shapes
As it edits, the skill explains each change and its motivation inline. On completion, it produces a checklist of items that require manual verification (typically integration tests, length-control prompt tuning, and cost/rate-limit re-baselining).
For the full list of model-specific changes the skill applies, see [Migrating to Claude Opus 5.5 from Claude Opus 5](/docs/en/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Migrating to Claude Opus 5.5 from Claude Opus 4.8](/docs/en/models/opus-5-5/migration-guide#migrating-from-claude-opus-4-8), and [Migrating to Claude Fable 5.1](/docs/en/models/fable-5-1/migration-guide).
## Setting up a Managed Agent
To scaffold a new Managed Agent from scratch, invoke the `managed-agents-onboard` subcommand:
```python
/claude-api managed-agents-onboard
```
The skill runs an interview that walks you through the Managed Agents mental model (Agent configs versus Sessions), templates an agent config, configures environments and tools, sets up the session loop, and emits runnable code for your language. The skill also covers the mandatory **Agent (once) → Session (every run)** flow: `model`, `system`, and `tools` live on the agent, never on the session, and agents should be created once and referenced by ID.
Managed Agents requires the `managed-agents-2026-04-01` beta header, which the SDK sets automatically for all `client.beta.agents.*`, `client.beta.environments.*`, `client.beta.sessions.*`, and `client.beta.vaults.*` calls.
## Example usage
Here are examples of tasks the skill helps Claude handle:
**Building a chat application:**
``` block
Build a streaming chat UI with the Claude API in TypeScript
```
**Migrating an existing project:**
```python
/claude-api migrate this codebase to claude-opus-5-5 and re-tune effort
```
**Onboarding a new Managed Agent:**
```python
/claude-api managed-agents-onboard
```
In each case, the skill loads the relevant language-specific documentation and guides Claude through the implementation using current API patterns and best practices.
## Next steps
[Agent Skills overview](/docs/en/agents-and-tools/agent-skills/overview)
Learn about how Agent Skills work and the progressive disclosure model
[Client SDKs](/docs/en/cli-sdks-libraries/overview)
Browse the official Anthropic SDKs for all supported languages
[Skills repository](https://github.com/anthropics/skills)
Explore the public Anthropic skills repository on GitHub
---
## amazon-bedrock.md
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Claude Code on Amazon Bedrock
> Learn about configuring Claude Code through Amazon Bedrock, including setup, IAM configuration, and troubleshooting.
## Prerequisites
Before configuring Claude Code with Bedrock, ensure you have:
* An AWS account with Bedrock access enabled
* Access to desired Claude models (for example, Claude Sonnet 4.5) in Bedrock
* AWS CLI installed and configured (optional - only needed if you don't have another mechanism for getting credentials)
* Appropriate IAM permissions
## Setup
### 1. Submit use case details
First-time users of Anthropic models are required to submit use case details before invoking a model. This is done once per account.
1. Ensure you have the right IAM permissions (see more on that below)
2. Navigate to the [Amazon Bedrock console](https://console.aws.amazon.com/bedrock/)
3. Select **Chat/Text playground**
4. Choose any Anthropic model and you will be prompted to fill out the use case form
### 2. Configure AWS credentials
Claude Code uses the default AWS SDK credential chain. Set up your credentials using one of these methods:
**Option A: AWS CLI configuration**
```bash theme={null}
aws configure
```
**Option B: Environment variables (access key)**
```bash theme={null}
export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token
```
**Option C: Environment variables (SSO profile)**
```bash theme={null}
aws sso login --profile=
export AWS_PROFILE=your-profile-name
```
**Option D: AWS Management Console credentials**
```bash theme={null}
aws login
```
[Learn more](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) about `aws login`.
**Option E: Bedrock API keys**
```bash theme={null}
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
```
Bedrock API keys provide a simpler authentication method without needing full AWS credentials. [Learn more about Bedrock API keys](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).
#### Advanced credential configuration
Claude Code supports automatic credential refresh for AWS SSO and corporate identity providers. Add these settings to your Claude Code settings file (see [Settings](../02-Claude-Code-CLI/claude-code-settings-claude-code-docs-d4420b4b52.md) for file locations).
When Claude Code detects that your AWS credentials are expired (either locally based on their timestamp or when Bedrock returns a credential error), it will automatically run your configured `awsAuthRefresh` and/or `awsCredentialExport` commands to obtain new credentials before retrying the request.
##### Example configuration
```json theme={null}
{
"awsAuthRefresh": "aws sso login --profile myprofile",
"env": {
"AWS_PROFILE": "myprofile"
}
}
```
##### Configuration settings explained
**`awsAuthRefresh`**: Use this for commands that modify the `.aws` directory, such as updating credentials, SSO cache, or config files. The command's output is displayed to the user, but interactive input isn't supported. This works well for browser-based SSO flows where the CLI displays a URL or code and you complete authentication in the browser.
**`awsCredentialExport`**: Only use this if you can't modify `.aws` and must directly return credentials. Output is captured silently and not shown to the user. The command must output JSON in this format:
```json theme={null}
{
"Credentials": {
"AccessKeyId": "value",
"SecretAccessKey": "value",
"SessionToken": "value"
}
}
```
### 3. Configure Claude Code
Set the following environment variables to enable Bedrock:
```bash theme={null}
# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1 # or your preferred region
# Optional: Override the region for the small/fast model (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2
```
When enabling Bedrock for Claude Code, keep the following in mind:
* `AWS_REGION` is a required environment variable. Claude Code does not read from the `.aws` config file for this setting.
* When using Bedrock, the `/login` and `/logout` commands are disabled since authentication is handled through AWS credentials.
* You can use settings files for environment variables like `AWS_PROFILE` that you don't want to leak to other processes. See [Settings](../02-Claude-Code-CLI/claude-code-settings-claude-code-docs-d4420b4b52.md) for more information.
### 4. Model configuration
Claude Code uses these default models for Bedrock:
| Model type | Default value |
| :--------------- | :------------------------------------------------- |
| Primary model | `global.anthropic.claude-sonnet-4-5-20250929-v1:0` |
| Small/fast model | `us.anthropic.claude-haiku-4-5-20251001-v1:0` |
For Bedrock users, Claude Code won't automatically upgrade from Haiku 3.5 to Haiku 4.5. To manually switch to a newer Haiku model, set the `ANTHROPIC_DEFAULT_HAIKU_MODEL` environment variable to the full model name (for example, `us.anthropic.claude-haiku-4-5-20251001-v1:0`).
To customize models, use one of these methods:
```bash theme={null}
# Using inference profile ID
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'
# Using application inference profile ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'
# Optional: Disable prompt caching if needed
export DISABLE_PROMPT_CACHING=1
```
[Prompt caching](https://docs.claude.com/en/docs/build-with-claude/prompt-caching) may not be available in all regions.
### 5. Output token configuration
These are the recommended token settings for Claude Code with Amazon Bedrock:
```bash theme={null}
# Recommended output token settings for Bedrock
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024
```
**Why these values:**
* **`CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096`**: Bedrock's burndown throttling logic sets a minimum of 4096 tokens as the `max_token` penalty. Setting this lower won't reduce costs but may cut off long tool uses, causing the Claude Code agent loop to fail persistently. Claude Code typically uses less than 4096 output tokens without extended thinking, but may need this headroom for tasks involving significant file creation or Write tool usage.
* **`MAX_THINKING_TOKENS=1024`**: This provides space for extended thinking without cutting off tool use responses, while still maintaining focused reasoning chains. This balance helps prevent trajectory changes that aren't always helpful for coding tasks specifically.
## IAM configuration
Create an IAM policy with the required permissions for Claude Code:
```json theme={null}
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModelAndInferenceProfileAccess",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream",
"bedrock:ListInferenceProfiles"
],
"Resource": [
"arn:aws:bedrock:*:*:inference-profile/*",
"arn:aws:bedrock:*:*:application-inference-profile/*",
"arn:aws:bedrock:*:*:foundation-model/*"
]
},
{
"Sid": "AllowMarketplaceSubscription",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Subscribe"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:CalledViaLast": "bedrock.amazonaws.com"
}
}
}
]
}
```
For more restrictive permissions, you can limit the Resource to specific inference profile ARNs.
For details, see [Bedrock IAM documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html).
We recommend creating a dedicated AWS account for Claude Code to simplify cost tracking and access control.
## AWS Guardrails
[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) let you implement content filtering for Claude Code. Create a Guardrail in the [Amazon Bedrock console](https://console.aws.amazon.com/bedrock/), publish a version, then add the Guardrail headers to your [settings file](../02-Claude-Code-CLI/claude-code-settings-claude-code-docs-d4420b4b52.md). Enable Cross-Region inference on your Guardrail if you're using cross-region inference profiles.
Example configuration:
```json theme={null}
{
"env": {
"ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
}
}
```
## Troubleshooting
If you encounter region issues:
* Check model availability: `aws bedrock list-inference-profiles --region your-region`
* Switch to a supported region: `export AWS_REGION=us-east-1`
* Consider using inference profiles for cross-region access
If you receive an error "on-demand throughput isn’t supported":
* Specify the model as an [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) ID
Claude Code uses the Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) and does not support the Converse API.
## Additional resources
* [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)
* [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)
* [Bedrock inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)
* [Claude Code on Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)- [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)
---
## api-beta-models-5b6f2e637e.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fbeta%2Fmodels)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
# Models
##### [List Models](/docs/en/api/http/beta/models/list)
GET/v1/models
List available models.
##### [Get a Model](/docs/en/api/http/beta/models/retrieve)
GET/v1/models/{model_id}
Get a specific model.
##### Models
BetaCapabilitySupport object{ supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
BetaCompactionCapability object{ summarize, supported }
Compaction capability details: whether the model accepts the top-level `compaction` request parameter, with one entry per supported `compaction.type` value.
summarize: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the summarize compaction type is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaContextManagementCapability object{ clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management capability details.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the clear_thinking_20251015 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the clear_tool_uses_20250919 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the compact_20260112 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaEffortCapability object{ high, low, max, 3 more }
Effort (reasoning_effort) capability details.
BetaModelCapabilities object{ batch, citations, code_execution, 7 more }
Model capability information.
BetaModelInfo object{ type: "model", id, allowed_fallback_models, 5 more }
BetaThinkingCapability object{ supported, types }
Thinking capability details.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/http/beta/models#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
BetaThinkingTypes object{ adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
---
## api-beta-models-a2ec582f9d.md
# Models
## List
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Query Parameters
- `after_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `before_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `data: array of BetaModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: BetaModelCapabilities`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```http
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
## Retrieve
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Path Parameters
- `model_id: string`
Model identifier or alias.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `BetaModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: BetaModelCapabilities`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Example
```http
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
## Domain Types
### Beta Capability Support
- `BetaCapabilitySupport = object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Context Management Capability
- `BetaContextManagementCapability = object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management capability details.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Effort Capability
- `BetaEffortCapability = object { high, low, max, 2 more }`
Effort (reasoning_effort) capability details.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Model Capabilities
- `BetaModelCapabilities = object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Model Info
- `BetaModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: BetaModelCapabilities`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Beta Thinking Capability
- `BetaThinkingCapability = object { supported, types }`
Thinking capability details.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Thinking Types
- `BetaThinkingTypes = object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
---
## api-beta-models-list-46fe2c6773.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fbeta%2Fmodels%2Flist)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
3. [Models](/docs/en/api/http/beta/models)
# List Models
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### Query parameters
after_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
before_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
default20
minimum1
maximum1000
##### Headers
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
##### Returns
data: array of [BetaModelInfo](/docs/en/api/http/beta/models#beta_model_info) { type: "model", id, allowed_fallback_models, 5 more }
type: "model"
Object type.
For Models, this is always `"model"`.
defaultmodel
id: string
Unique model identifier.
allowed_fallback_models: array of string or null
Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An empty list means the `fallbacks` parameter is not supported for this model as primary.
capabilities: [BetaModelCapabilities](/docs/en/api/http/beta/models#beta_model_capabilities) { batch, citations, code_execution, 7 more } or null
Object mapping capability names to their support details. Keys are always present for all known capabilities.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
formatdate-time
display_name: string
A human-readable name for the model.
max_input_tokens: number or null
Maximum input context window size in tokens for this model.
max_tokens: number or null
Maximum value for the `max_tokens` parameter when using this model.
first_id: string or null
First ID in the `data` list. Can be used as the `before_id` for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string or null
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
cURL
```python
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-beta-models-list-ae1bbbc10a.md
## List
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Query Parameters
- `after_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `before_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `data: array of BetaModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: BetaModelCapabilities`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```http
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
---
## api-beta-models-list.md
# List Models
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### Query ParametersExpand Collapse
after_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
before_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
##### Header ParametersExpand Collapse
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
Accepts one of the following:
UnionMember0 = string
UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more
Accepts one of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
##### ReturnsExpand Collapse
data: array of [BetaModelInfo](/docs/en/api/beta#beta_model_info) { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
first_id: string
First ID in the `data` list. Can be used as the `before_id` for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
cURL
```python
curl https://api.anthropic.com/v1/models?beta=true \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-beta-models-retrieve-14ec84a11d.md
## Retrieve
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Path Parameters
- `model_id: string`
Model identifier or alias.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `BetaModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: BetaModelCapabilities`
Model capability information.
- `batch: BetaCapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: BetaCapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: BetaCapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: BetaContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: BetaCapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: BetaCapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: BetaCapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: BetaCapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: BetaCapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: BetaThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: BetaThinkingTypes`
Supported thinking type configurations.
- `adaptive: BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Example
```http
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
---
## api-beta-models-retrieve-672ee26e06.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fbeta%2Fmodels%2Fretrieve)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
3. [Models](/docs/en/api/http/beta/models)
# Get a Model
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### Path parameters
model_id: string
Model identifier or alias.
##### Headers
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
##### Returns
BetaModelInfo object{ type: "model", id, allowed_fallback_models, 5 more }
Get a Model
cURL
```python
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-beta-models-retrieve.md
# Get a Model
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### Path ParametersExpand Collapse
model_id: string
Model identifier or alias.
##### Header ParametersExpand Collapse
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
Accepts one of the following:
UnionMember0 = string
UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more
Accepts one of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
##### ReturnsExpand Collapse
BetaModelInfo = object { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
Get a Model
cURL
```python
curl https://api.anthropic.com/v1/models/$MODEL_ID?beta=true \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-beta-models.md
# Models
##### [List Models](/docs/en/api/beta/models/list)
GET/v1/models
##### [Get a Model](/docs/en/api/beta/models/retrieve)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
BetaCapabilitySupport = object { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
BetaContextManagementCapability = object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management capability details.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaEffortCapability = object { high, low, max, 2 more }
Effort (reasoning_effort) capability details.
high: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaModelCapabilities = object { batch, citations, code_execution, 6 more }
Model capability information.
batch: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
BetaModelInfo = object { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
BetaThinkingCapability = object { supported, types }
Thinking capability details.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
BetaThinkingTypes = object { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
---
## api-claude-code-routines-fire-d96a9582fb.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fclaude-code%2Froutines-fire)
SearchCtrlK
Include beta APIsThe API you’re viewing is only available in beta
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
[API reference](/docs/en/api/overview)Claude Code
# Trigger a routine through the API
Copy page
Start a Claude Code routine session on demand by sending an authenticated POST request.
Copy page
This is an experimental API. Request and response shapes, rate limits, and token semantics might change.
[Claude Code](https://code.claude.com/docs) is Anthropic's agentic coding tool. [Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web) runs Claude Code sessions on Anthropic-managed cloud infrastructure at claude.ai/code, and a [routine](https://code.claude.com/docs/en/routines) is a saved configuration there: a prompt, one or more repositories, and connectors, packaged so it can run unattended on a schedule, in response to GitHub events, or when called over HTTP.
This endpoint is the HTTP entry point. POSTing to it starts a new run of an existing routine and returns the resulting session ID and URL. Typical callers are alerting systems, CI pipelines, and internal tools that need to start a Claude Code session programmatically.
Calling this endpoint requires a claude.ai account on a Pro, Max, Team, or Enterprise plan with [Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web) enabled. Authenticate with a per-routine bearer token created in the Claude Code web UI rather than a Claude API key.
## Differences from the Claude Platform
The routine fire endpoint belongs to the Claude Code product surface, which differs from the Claude Platform APIs and SDKs in a few ways:
| Aspect | This endpoint | Claude Platform APIs |
|:---------------|:--------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------|
| Authentication | `Authorization: Bearer` with a per-routine token (`sk-ant-oat01-...`) created at [claude.ai/code/routines](https://claude.ai/code/routines) | `x-api-key` with a Claude API key from Claude Console |
| Token scope | One routine only; no read access | Workspace-level |
| SDK support | None | Available in all [client SDKs](/docs/en/cli-sdks-libraries/overview) |
| Billing | Claude Code subscription usage on claude.ai | Claude Platform usage |
| Path namespace | `/v1/claude_code/...` | `/v1/...` |
| Stability | Experimental | Stable or standard beta |
## Before you begin
To call this endpoint, you need:
1. A routine created at [claude.ai/code/routines](https://claude.ai/code/routines).
2. A bearer token generated for that routine: open the routine for editing, click **Add another trigger** under **Select a trigger**, choose **API**, then click **Generate token** in the modal window. The token is shown once and cannot be retrieved later.
See [Add an API trigger](https://code.claude.com/docs/en/routines#add-an-api-trigger) in the Claude Code documentation for the full setup walkthrough.
## Trigger a routine
```python
POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire
```
The Claude Code web UI provides the full URL alongside the token when you add an API trigger, so most integrations store both as secrets and call the endpoint directly. The following examples show a shell call and a GitHub Actions step that triggers the routine on CI failure.
cURL
```python
curl -X POST https://api.anthropic.com/v1/claude_code/routines/$ROUTINE_ID/fire \
-H "Authorization: Bearer $ROUTINE_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
```
```python
- if: failure()
env:
ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
run: |
curl -X POST "$ROUTINE_FIRE_URL" \
-H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"
```
The request returns once the session is created. It does not stream session output or wait for the session to complete.
### Headers
| Name | Required | Description |
|:--------------------|:---------------------|:-----------------------------------------------------------------------------------------------------|
| `Authorization` | Yes | `Bearer `. The per-routine token created in the Claude Code web UI, prefixed `sk-ant-oat01-`. |
| `anthropic-version` | Yes | The [API version](/docs/en/api/versioning). `2023-06-01` is the only accepted value. |
| `Content-Type` | When body is present | `application/json`. |
Older integrations that send an `anthropic-beta: experimental-cc-routine-2026-04-01` header are unaffected: the endpoint accepts requests with and without it.
### Path parameters
| Name | Type | Description |
|:-------------|:-------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `routine_id` | string | The routine's identifier. Despite the parameter name, the value is prefixed `trig_` rather than `routine_`. Included in the URL the modal window shows when you add an API trigger. |
### Request body
| Field | Type | Required | Description |
|:-------|:-------|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `text` | string | No | Initial context for this run, such as an alert body, a failing log line, or a git diff. The value is freeform text and is not parsed; if you send JSON or another structured payload, the routine receives it as a literal string. Passed to the routine alongside its saved prompt. Maximum 65,536 characters. |
The body is optional. Unknown fields in the body are ignored.
### Response
A successful request returns `200 OK` with the new session details:
```python
{
"type": "routine_fire",
"claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
"claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
```
| Field | Type | Description |
|:--------------------------|:-------|:-------------------------------------------------------------------------------------------------------------------------|
| `type` | string | Always `routine_fire`. |
| `claude_code_session_id` | string | The ID of the Claude Code session created for this run. |
| `claude_code_session_url` | string | A link to the session on claude.ai. Open it in a browser to watch the run, review changes, or continue the conversation. |
### Errors
Errors use the standard Anthropic [error envelope](/docs/en/api/errors):
```python
{
"type": "error",
"error": {
"type": "not_found_error",
"message": ""
}
}
```
| HTTP status | Error type | Cause |
|:------------|:------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 400 | `invalid_request_error` | Missing or unsupported `anthropic-version` header, `text` exceeds 65,536 characters, or the routine is paused (see [Edit and control routines](https://code.claude.com/docs/en/routines#edit-and-control-routines)). |
| 401 | `authentication_error` | No bearer token in the `Authorization` header, or the token does not match this routine. |
| 403 | `permission_error` | The account or organization does not have access to this endpoint. |
| 404 | `not_found_error` | The routine does not exist. |
| 429 | `rate_limit_error` | An hourly fire limit for the routine or the account has been reached. The response includes a `Retry-After` header indicating when the window resets. |
| 500 | `api_error` | An unexpected server error. Retry with exponential backoff; if the error persists, contact support with the request ID. |
| 503 | `overloaded_error` | The service is temporarily overloaded. Retry after a short delay. The Claude Platform returns 529 for this error type; this endpoint returns 503. |
## Authentication
The bearer token is scoped to a single routine. A compromised token can only trigger that routine; it grants no read access, no access to other routines, and no access to account data.
Generate and revoke tokens from the routine's API trigger settings at [claude.ai/code/routines](https://claude.ai/code/routines). There is no public API for token management. Generating a new token revokes the previous one.
## Idempotency
Each successful request creates a new session. There is no idempotency key. If a webhook caller retries, the endpoint creates multiple sessions.
## Rate limits
API fires are limited per hour: each routine accepts up to 30 fires per hour (shared across API fires, the **Run now** button in the web UI, and one-shot re-arms), and each account can make up to 100 API fires per hour across all routines. The resulting sessions draw down the same Claude Code subscription usage as interactive sessions. When a limit is reached, the endpoint returns `429 rate_limit_error` with a `Retry-After` header.
To learn how routine usage interacts with subscription limits and extra usage billing, see [Usage and limits](https://code.claude.com/docs/en/routines#usage-and-limits) in the Claude Code documentation.
## SDK support
This endpoint is not in the Anthropic SDKs. Its token model differs from API key authentication, and typical callers such as CI jobs and alerting webhooks send the request directly.
## See also
- [Automate work with routines](https://code.claude.com/docs/en/routines) in the Claude Code documentation
- [Errors](/docs/en/api/errors)
---
## api-claude-code-routines-fire-df6c51ff06.md
# Trigger a routine via API
Start a Claude Code routine session on demand by sending an authenticated POST request.
---
This is an experimental API. Request and response shapes, rate limits, and token semantics may change. Breaking changes ship behind new dated beta header versions, and the two previous header versions continue to work so that callers have time to migrate.
[Claude Code](../02-Claude-Code-CLI/claude-code-overview-claude-code-docs.md) is Anthropic's agentic coding tool. [Claude Code on the web](../02-Claude-Code-CLI/claude-code-on-the-web-69d53821d4.md) runs Claude Code sessions on Anthropic-managed cloud infrastructure at claude.ai/code, and a [routine](../02-Claude-Code-CLI/routines-3111c7bd3a.md) is a saved configuration there: a prompt, one or more repositories, and connectors, packaged so it can run unattended on a schedule, in response to GitHub events, or when called over HTTP.
This endpoint is the HTTP entry point. POSTing to it starts a new run of an existing routine and returns the resulting session ID and URL. Typical callers are alerting systems, CI pipelines, and internal tools that need to start a Claude Code session programmatically.
Calling this endpoint requires a claude.ai account on a Pro, Max, Team, or Enterprise plan with [Claude Code on the web](../02-Claude-Code-CLI/claude-code-on-the-web-69d53821d4.md) enabled. Authenticate with a per-routine bearer token created in the Claude Code web UI rather than an Anthropic API key.
## Differences from the Claude Platform
The routine fire endpoint belongs to the Claude Code product surface, which differs from the Claude Platform APIs and SDKs in a few ways:
| Aspect | This endpoint | Other Anthropic APIs |
| :--- | :--- | :--- |
| Authentication | `Authorization: Bearer` with a per-routine token (`sk-ant-oat01-...`) created at [claude.ai/code/routines](https://claude.ai/code/routines) | `x-api-key` with an Anthropic API key from Claude Console |
| Token scope | One routine only; no read access | Workspace-level |
| SDK support | None | Available in all [client SDKs](/docs/en/api/client-sdks) |
| Billing | Claude Code subscription usage on claude.ai | Claude Platform usage |
| Path namespace | `/v1/claude_code/...` | `/v1/...` |
| Stability | Experimental; requires `anthropic-beta: experimental-cc-routine-2026-04-01` | Stable or standard beta |
## Before you begin
To call this endpoint, you need:
1. A routine created at [claude.ai/code/routines](https://claude.ai/code/routines)
2. A bearer token generated for that routine: open the routine for editing, click **Add another trigger** under **Select a trigger**, choose **API**, then click **Generate token** in the modal. The token is shown once and cannot be retrieved later.
See [Add an API trigger](../02-Claude-Code-CLI/routines-3111c7bd3a.md#add-an-api-trigger) in the Claude Code documentation for the full setup walkthrough.
## Trigger a routine
```http
POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire
```
Every request must include the `anthropic-beta: experimental-cc-routine-2026-04-01` header. Requests without it return `400 invalid_request_error`.
The Claude Code web UI provides the full URL alongside the token when you add an API trigger, so most integrations store both as secrets and call the endpoint directly. The examples below show a shell call and a GitHub Actions step that triggers the routine on CI failure.
```bash cURL
curl -X POST https://api.anthropic.com/v1/claude_code/routines/$ROUTINE_ID/fire \
-H "Authorization: Bearer $ROUTINE_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
```
```yaml GitHub Actions
- if: failure()
env:
ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
run: |
curl -X POST "$ROUTINE_FIRE_URL" \
-H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "Content-Type: application/json" \
-d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"
```
The request returns once the session is created. It does not stream session output or wait for the session to complete.
### Headers
| Name | Required | Description |
| :--- | :--- | :--- |
| `Authorization` | Yes | `Bearer `. The per-routine token created in the Claude Code web UI, prefixed `sk-ant-oat01-`. |
| `anthropic-beta` | Yes | Must include `experimental-cc-routine-2026-04-01`. |
| `anthropic-version` | Yes | The [API version](/docs/en/api/versioning), for example `2023-06-01`. |
| `Content-Type` | When body is present | `application/json`. |
### Path parameters
| Name | Type | Description |
| :--- | :--- | :--- |
| `routine_id` | string | The routine's identifier. Despite the parameter name, the value is prefixed `trig_` rather than `routine_`. Included in the URL the modal shows when you add an API trigger. |
### Request body
| Field | Type | Required | Description |
| :--- | :--- | :--- | :--- |
| `text` | string | No | Initial context for this run, such as an alert body, a failing log line, or a git diff. The value is freeform text and is not parsed; if you send JSON or another structured payload, the routine receives it as a literal string. Passed to the routine alongside its saved prompt. Maximum 65,536 characters. |
The body is optional. Unknown fields in the body are ignored.
### Response
A successful request returns `200 OK` with the new session details:
```json
{
"type": "routine_fire",
"claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
"claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
```
| Field | Type | Description |
| :--- | :--- | :--- |
| `type` | string | Always `routine_fire`. |
| `claude_code_session_id` | string | The ID of the Claude Code session created for this run. |
| `claude_code_session_url` | string | A link to the session on claude.ai. Open it in a browser to watch the run, review changes, or continue the conversation. |
### Errors
Errors use the standard Anthropic [error envelope](/docs/en/api/errors):
```json
{
"type": "error",
"error": {
"type": "not_found_error",
"message": ""
}
}
```
| HTTP status | Error type | Cause |
| :--- | :--- | :--- |
| 400 | `invalid_request_error` | Missing or invalid `anthropic-beta` header, `text` exceeds 65,536 characters, or the routine is [paused](../02-Claude-Code-CLI/routines-3111c7bd3a.md#edit-and-control-routines). |
| 401 | `authentication_error` | No bearer token in the `Authorization` header, or the token does not match this routine. |
| 403 | `permission_error` | The account or organization does not have access to this endpoint. |
| 404 | `not_found_error` | The routine does not exist. |
| 429 | `rate_limit_error` | The account's routine run limit or usage limit has been reached. The response includes a `Retry-After` header indicating when the window resets. |
| 500 | `api_error` | An unexpected server error. |
| 503 | `overloaded_error` | The service is temporarily overloaded. Retry after a short delay. The Claude Platform returns 529 for this error type; this endpoint returns 503. |
## Authentication
The bearer token is scoped to a single routine. A compromised token can only trigger that routine; it grants no read access, no access to other routines, and no access to account data.
Generate and revoke tokens from the routine's API trigger settings at [claude.ai/code/routines](https://claude.ai/code/routines). There is no public API for token management. Generating a new token revokes the previous one.
## Idempotency
Each successful request creates a new session. There is no idempotency key. If a webhook caller retries, the endpoint creates multiple sessions.
## Rate limits
Routine runs count against a per-account daily allowance that varies by plan, and the resulting sessions draw down the same Claude Code subscription usage as interactive sessions. When either limit is reached, the endpoint returns `429 rate_limit_error` with a `Retry-After` header. Organizations with extra usage enabled continue past the included allowance on metered overage.
Your remaining daily runs are shown at [claude.ai/code/routines](https://claude.ai/code/routines). For how routine usage interacts with subscription limits and extra usage billing, see [Usage and limits](../02-Claude-Code-CLI/routines-3111c7bd3a.md#usage-and-limits) in the Claude Code documentation.
## SDK support
This endpoint is not in the Anthropic SDKs. Its token model differs from API key authentication, and typical callers such as CI jobs and alerting webhooks send the request directly.
## See also
- [Automate work with routines](../02-Claude-Code-CLI/routines-3111c7bd3a.md) in the Claude Code documentation
- [Beta headers](/docs/en/api/beta-headers)
- [Errors](/docs/en/api/errors)
---
## api-claude-on-amazon-bedrock.md
# Claude on Amazon Bedrock
Anthropic's Claude models are now generally available through Amazon Bedrock.
Calling Claude through Bedrock slightly differs from how you would call Claude when using Anthropic's client SDKs. This guide walks you through completing an API call to Claude on Bedrock using one of Anthropic's [client SDKs](/docs/en/api/client-sdks).
Note that this guide assumes you have already signed up for an [AWS account](https://portal.aws.amazon.com/billing/signup) and configured programmatic access.
Install and configure the AWS CLI
1. [Install a version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) at or newer than version `2.13.23`
2. Configure your AWS credentials using the AWS configure command (see [Configure the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)) or find your credentials by navigating to "Command line or programmatic access" within your AWS dashboard and following the directions in the popup modal.
3. Verify that your credentials are working:
Shell
```python
aws sts get-caller-identity
```
Install an SDK for accessing Bedrock
Anthropic's [client SDKs](/docs/en/api/client-sdks) support Bedrock. You can also use an AWS SDK like `boto3` directly.
Python
Python
TypeScript
TypeScript
C#
C#
Go
Go
Java
Java
PHP
PHP
Ruby
Ruby
Boto3 (Python)
Boto3 (Python)
```python
pip install -U "anthropic[bedrock]"
```
Accessing Bedrock
Subscribe to Anthropic models
Go to the [AWS Console \> Bedrock \> Model Access](https://console.aws.amazon.com/bedrock/home?region=us-west-2#/modelaccess) and request access to Anthropic models. Note that Anthropic model availability varies by region. See [AWS documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/models-regions.html) for latest information.
API model IDs
| Model | Base Bedrock model ID | `global` | `us` | `eu` | `jp` | `apac` |
|----|----|----|----|----|----|----|
| Claude Opus 4.6 | anthropic.claude-opus-4-6-v1 | Yes | Yes | Yes | Yes | Yes |
| Claude Sonnet 4.6 | anthropic.claude-sonnet-4-6 | Yes | Yes | Yes | Yes | No |
| Claude Sonnet 4.5 | anthropic.claude-sonnet-4-5-20250929-v1:0 | Yes | Yes | Yes | Yes | No |
| Claude Sonnet 4 | anthropic.claude-sonnet-4-20250514-v1:0 | Yes | Yes | Yes | No | Yes |
| Claude Sonnet 3.7 ⚠️ | anthropic.claude-3-7-sonnet-20250219-v1:0 | No | Yes | Yes | No | Yes |
| Claude Opus 4.5 | anthropic.claude-opus-4-5-20251101-v1:0 | Yes | Yes | Yes | No | No |
| Claude Opus 4.1 | anthropic.claude-opus-4-1-20250805-v1:0 | No | Yes | No | No | No |
| Claude Opus 4 | anthropic.claude-opus-4-20250514-v1:0 | No | Yes | No | No | No |
| Claude Haiku 4.5 | anthropic.claude-haiku-4-5-20251001-v1:0 | Yes | Yes | Yes | No | No |
| Claude Haiku 3.5 ⚠️ | anthropic.claude-3-5-haiku-20241022-v1:0 | No | Yes | No | No | No |
| Claude Haiku 3 ⚠️ | anthropic.claude-3-haiku-20240307-v1:0 | No | Yes | Yes | No | Yes |
For more information about regional vs global model IDs, see the [Global vs regional endpoints](#global-vs-regional-endpoints) section below.
List available models
The following examples show how to print a list of all the Claude models available through Bedrock:
AWS CLI
```python
aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"
```
Making requests
The following examples show how to generate text from Claude on Bedrock:
Python
```python
from anthropic import AnthropicBedrock
client = AnthropicBedrock(
# Authenticate by either providing the keys below or use the default AWS credential providers, such as
# using ~/.aws/credentials or the "AWS_SECRET_ACCESS_KEY" and "AWS_ACCESS_KEY_ID" environment variables.
aws_access_key="",
aws_secret_key="",
# Temporary credentials can be used with aws_session_token.
# Read more at https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
aws_session_token="",
# aws_region changes the aws region to which the request is made. By default, we read AWS_REGION,
# and if that's not present, we default to us-east-1. Note that we do not read ~/.aws/config for the region.
aws_region="us-west-2",
)
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
print(message.content)
```
See the [client SDKs](/docs/en/api/client-sdks) for more details, and the [official Bedrock documentation](https://docs.aws.amazon.com/bedrock/).
Bearer token authentication
You can authenticate with Bedrock using bearer tokens instead of AWS credentials. This is useful in corporate environments where teams need access to Bedrock without managing AWS credentials, IAM roles, or account-level permissions.
Bearer token authentication is supported in the C#, Go, and Java SDKs. The PHP, Python, TypeScript, and Ruby SDKs use AWS SigV4 signing only.
The simplest approach is to set the `AWS_BEARER_TOKEN_BEDROCK` environment variable, which is automatically detected by `fromEnv()` credential resolution.
To provide a token programmatically:
C#
```python
using Anthropic.Bedrock;
using Anthropic.Models.Messages;
var client = new AnthropicBedrockClient(
new AnthropicBedrockApiTokenCredentials
{
BearerToken = "your-bearer-token",
Region = "us-east-1",
}
);
var response = await client.Messages.Create(new MessageCreateParams
{
Model = "us.anthropic.claude-sonnet-4-5-20250929-v1:0",
MaxTokens = 1024,
Messages = [new() { Role = Role.User, Content = "Hello!" }],
});
```
Activity logging
Bedrock provides an [invocation logging service](https://docs.aws.amazon.com/bedrock/latest/userguide/model-invocation-logging.html) that allows customers to log the prompts and completions associated with your usage.
Anthropic recommends that you log your activity on at least a 30-day rolling basis in order to understand your activity and investigate any potential misuse.
Turning on this service does not give AWS or Anthropic any access to your content.
Feature support
For all currently supported features on Bedrock, see [API features overview](/docs/en/api/overview).
PDF support on Bedrock
PDF support is available on Amazon Bedrock through both the Converse API and InvokeModel API. For detailed information about PDF processing capabilities and limitations, see the [PDF support documentation](/docs/en/build-with-claude/pdf-support#amazon-bedrock-pdf-support).
**Important considerations for Converse API users:**
- Visual PDF analysis (charts, images, layouts) requires citations to be enabled
- Without citations, only basic text extraction is available
- For full control without forced citations, use the InvokeModel API
For more details on the two document processing modes and their limitations, refer to the [PDF support guide](/docs/en/build-with-claude/pdf-support#amazon-bedrock-pdf-support).
Context window
Claude Opus 4.6, Sonnet 4.6, Sonnet 4.5, and Sonnet 4 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Amazon Bedrock.
For Claude Sonnet 4.5 and Sonnet 4, the 1M-token context window is in beta. To use, include the `context-1m-2025-08-07` beta header in your [Bedrock API requests](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html).
Amazon Bedrock limits request payloads to 20 MB. When sending large documents or many images, you may reach this limit before the token limit.
Global vs regional endpoints
Starting with **Claude Sonnet 4.5 and all future models**, Amazon Bedrock offers two endpoint types:
- **Global endpoints:** Dynamic routing for maximum availability
- **Regional endpoints:** Guaranteed data routing through specific geographic regions
Regional endpoints include a 10% pricing premium over global endpoints.
This applies to Claude Sonnet 4.5 and future models only. Older models (Claude Sonnet 4, Opus 4, and earlier) maintain their existing pricing structures.
When to use each option
**Global endpoints (recommended):**
- Provide maximum availability and uptime
- Dynamically route requests to regions with available capacity
- No pricing premium
- Best for applications where data residency is flexible
**Regional endpoints (CRIS):**
- Route traffic through specific geographic regions
- Required for data residency and compliance requirements
- Available for US, EU, Japan, and Australia
- 10% pricing premium reflects infrastructure costs for dedicated regional capacity
Implementation
**Using global endpoints (default for Opus 4.6, Sonnet 4.5, and Sonnet 4):**
The model IDs for Claude Sonnet 4.5 and 4 already include the `global.` prefix:
Python
```python
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
message = client.messages.create(
model="global.anthropic.claude-opus-4-6-v1",
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
```
**Using regional endpoints (CRIS):**
To use regional endpoints, remove the `global.` prefix from the model ID:
Python
```python
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-west-2")
# Using US regional endpoint (CRIS)
message = client.messages.create(
model="anthropic.claude-opus-4-6-v1", # No global. prefix
max_tokens=256,
messages=[{"role": "user", "content": "Hello, world"}],
)
```
Additional resources
- **AWS Bedrock pricing:** [aws.amazon.com/bedrock/pricing](https://aws.amazon.com/bedrock/pricing/)
- **AWS pricing documentation:** [Bedrock pricing guide](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-pricing.html)
- **AWS blog post:** [Introducing Claude Sonnet 4.5 in Amazon Bedrock](https://aws.amazon.com/blogs/aws/introducing-claude-sonnet-4-5-in-amazon-bedrock-anthropics-most-intelligent-model-best-for-coding-and-complex-agents/)
- **Anthropic pricing details:** [Pricing documentation](/docs/en/about-claude/pricing#third-party-platform-pricing)
---
## api-claude-on-vertex-ai-7ed9b92e0b.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fbuild-with-claude%2Fclaude-on-vertex-ai)
SearchCtrlK
First steps
[Intro to Claude](/docs/en/intro)[Get your API key](/docs/en/get-api-key)[Quickstart](/docs/en/get-started)[Authentication](/docs/en/manage-claude/authentication)
Building with Claude
[Features overview](/docs/en/build-with-claude/overview)[Using the Messages API](/docs/en/build-with-claude/working-with-messages)[Stop reasons and fallback](/docs/en/build-with-claude/handling-stop-reasons)[Refusals and fallback](/docs/en/build-with-claude/refusals-and-fallback)[Fallback credit](/docs/en/build-with-claude/fallback-credit)
Model capabilities
[Effort](/docs/en/build-with-claude/effort)[Task budgets (beta)](/docs/en/build-with-claude/task-budgets)[Fast mode (research preview)](/docs/en/build-with-claude/fast-mode)[Structured outputs](/docs/en/build-with-claude/structured-outputs)[Citations](/docs/en/build-with-claude/citations)[Streaming Messages](/docs/en/build-with-claude/streaming)[Batch processing](/docs/en/build-with-claude/batch-processing)[Search results](/docs/en/build-with-claude/search-results)[Streaming refusals](/docs/en/test-and-evaluate/strengthen-guardrails/handle-streaming-refusals)[Multilingual support](/docs/en/build-with-claude/multilingual-support)[Embeddings](/docs/en/build-with-claude/embeddings)
[Thinking](/docs/en/build-with-claude/thinking)
Tools
[Overview](/docs/en/agents-and-tools/tool-use/overview)[How tool use works](/docs/en/agents-and-tools/tool-use/how-tool-use-works)[Tutorial: Build a tool-using agent](/docs/en/agents-and-tools/tool-use/build-a-tool-using-agent)[Define tools](/docs/en/agents-and-tools/tool-use/define-tools)[Handle tool calls](/docs/en/agents-and-tools/tool-use/handle-tool-calls)[Parallel tool use](/docs/en/agents-and-tools/tool-use/parallel-tool-use)[Tool Runner (SDK)](/docs/en/agents-and-tools/tool-use/tool-runner)[Strict tool use](/docs/en/agents-and-tools/tool-use/strict-tool-use)[Server tools](/docs/en/agents-and-tools/tool-use/server-tools)[Web search tool](/docs/en/agents-and-tools/tool-use/web-search-tool)[Web fetch tool](/docs/en/agents-and-tools/tool-use/web-fetch-tool)[Code execution tool](/docs/en/agents-and-tools/tool-use/code-execution-tool)[Advisor tool](/docs/en/agents-and-tools/tool-use/advisor-tool)[Tool search tool](/docs/en/agents-and-tools/tool-use/tool-search-tool)[Memory tool](/docs/en/agents-and-tools/tool-use/memory-tool)[Bash tool](/docs/en/agents-and-tools/tool-use/bash-tool)[Text editor tool](/docs/en/agents-and-tools/tool-use/text-editor-tool)[Computer use tool](/docs/en/agents-and-tools/tool-use/computer-use-tool)[Browser use tool](/docs/en/agents-and-tools/tool-use/browser-use-tool)[Troubleshooting](/docs/en/agents-and-tools/tool-use/troubleshooting-tool-use)
Tool infrastructure
[Tool reference](/docs/en/agents-and-tools/tool-use/tool-reference)[Manage tool context](/docs/en/agents-and-tools/tool-use/manage-tool-context)[Tool combinations](/docs/en/agents-and-tools/tool-use/tool-combinations)[Tool use with prompt caching](/docs/en/agents-and-tools/tool-use/tool-use-with-prompt-caching)[Programmatic tool calling](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling)[Fine-grained tool streaming](/docs/en/agents-and-tools/tool-use/fine-grained-tool-streaming)
Context management
[Context windows](/docs/en/build-with-claude/context-windows)[Context editing](/docs/en/build-with-claude/context-editing)[Prompt caching](/docs/en/build-with-claude/prompt-caching)[Mid-conversation system messages and tool changes](/docs/en/build-with-claude/mid-conversation-system-messages)[Build an orchestration mode](/docs/en/build-with-claude/mid-conversation-effort-example)[Cache diagnostics](/docs/en/build-with-claude/cache-diagnostics)[Token counting](/docs/en/build-with-claude/token-counting)
[Compaction](/docs/en/build-with-claude/compaction)
Working with files
[Files API](/docs/en/build-with-claude/files)[PDF support](/docs/en/build-with-claude/pdf-support)
[Images and vision](/docs/en/build-with-claude/vision)
Skills
[Overview](/docs/en/agents-and-tools/agent-skills/overview)[Quickstart](/docs/en/agents-and-tools/agent-skills/quickstart)[Best practices](/docs/en/agents-and-tools/agent-skills/best-practices)[Skills for enterprise](/docs/en/agents-and-tools/agent-skills/enterprise)[Skills in the API](/docs/en/build-with-claude/skills-guide)
MCP
[Remote MCP servers](/docs/en/agents-and-tools/remote-mcp-servers)[MCP connector](/docs/en/agents-and-tools/mcp-connector)
[MCP tunnels](/docs/en/agents-and-tools/mcp-tunnels/overview)
Claude on cloud platforms
[Amazon Bedrock (Opus 4.7 and later)](/docs/en/build-with-claude/claude-in-amazon-bedrock)[Amazon Bedrock (Opus 4.6 and earlier)](/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy)[Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws)[Google Cloud](/docs/en/build-with-claude/claude-on-vertex-ai)[Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry)
[Console](/)
[Messages](/docs/en/intro)Claude on cloud platforms
# Claude on Google Cloud
Copy page
Anthropic's Claude models are available through [Google Cloud's Agent Platform](https://cloud.google.com/vertex-ai).
Copy page
The API for accessing Claude on Google Cloud's Agent Platform is nearly identical to the [Messages API](/docs/en/api/messages/create), with two key differences in request format:
- On Agent Platform, `model` is not passed in the request body. Instead, it is specified in the Google Cloud endpoint URL.
- On Agent Platform, `anthropic_version` is passed in the request body (rather than as a header), and must be set to the value `vertex-2023-10-16`.
Agent Platform is also supported by Anthropic's official [client SDKs](/docs/en/cli-sdks-libraries/overview). This guide walks you through making a request to Claude on Agent Platform using one of Anthropic's client SDKs.
Note that this guide assumes you already have a Google Cloud project that is able to use Agent Platform. See [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) for more information on the setup required and a full walkthrough.
## Install an SDK for accessing Agent Platform
First, install Anthropic's [client SDK](/docs/en/cli-sdks-libraries/overview) for your language of choice.
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
pip install -U "anthropic[vertex]"
```
## Accessing Agent Platform
### Model availability
Note that Anthropic model availability varies by region. Search for "Claude" in the [Model Garden](https://cloud.google.com/model-garden) or go to [Anthropic Claude models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) for the latest information.
#### API model IDs
Lifecycle terms (Deprecated, Retired) are defined in [Model deprecations](/docs/en/about-claude/model-deprecations). Lifecycle dates on partner-operated platforms are set by the partner and can differ from the Claude API schedule. For the current retirement date of any model on Agent Platform, see [Google Cloud's documentation for Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude).
| Model | Agent Platform API model ID |
|-----------------------------------------------------------------------------------------------|-----------------------------|
| Claude Fable 5.1 | claude-fable-5-1 |
| Claude Mythos 5.1 ([limited availability(opens in new tab)](https://anthropic.com/glasswing)) | claude-mythos-5-1 |
| Claude Fable 5 | claude-fable-5 |
| Claude Mythos 5 ([limited availability(opens in new tab)](https://anthropic.com/glasswing)) | claude-mythos-5 |
| Claude Opus 5.5 | claude-opus-5-5 |
| Claude Opus 5 | claude-opus-5 |
| Claude Opus 4.8 | claude-opus-4-8 |
| Claude Opus 4.7 | claude-opus-4-7 |
| Claude Opus 4.6 | claude-opus-4-6 |
| Claude Opus 4.5 | claude-opus-4-5@20251101 |
| Claude Opus 4.1 ([deprecated](/docs/en/about-claude/model-deprecations)) | claude-opus-4-1@20250805 |
| Claude Opus 4 ([deprecated](/docs/en/about-claude/model-deprecations)) | claude-opus-4@20250514 |
| Claude Sonnet 5 | claude-sonnet-5 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Sonnet 4.5 | claude-sonnet-4-5@20250929 |
| Claude Sonnet 4 ([deprecated](/docs/en/about-claude/model-deprecations)) | claude-sonnet-4@20250514 |
| Claude Haiku 4.5 | claude-haiku-4-5@20251001 |
| Claude Haiku 3.5 ([deprecated](/docs/en/about-claude/model-deprecations)) | claude-3-5-haiku@20241022 |
Upgrading to a newer Claude model? In Claude Code, run `/claude-api migrate` to apply model ID swaps and breaking parameter changes across your codebase. The skill detects which cloud platform your code targets and adjusts model ID formats and feature changes for that platform. See [Migrating to a newer Claude model](/docs/en/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model).
### Making requests
Before running requests you might need to run `gcloud auth application-default login` to authenticate with Google Cloud.
The following examples show how to generate text from Claude on Agent Platform:
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "global"
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
See the [client SDKs](/docs/en/cli-sdks-libraries/overview) and the official [Agent Platform docs](https://cloud.google.com/vertex-ai/docs) for more details.
Claude is also available through [Amazon Bedrock](/docs/en/build-with-claude/claude-in-amazon-bedrock), [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws), and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry).
## Data retention
Data handling for this offering is governed by Google Cloud. For details, see [Agent Platform and zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance).
## Activity logging
Agent Platform provides a [request-response logging service](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging) that allows you to log the prompts and completions associated with your usage.
Anthropic recommends that you log your activity on at least a 30-day rolling basis to understand your activity and investigate any potential misuse.
Turning on this service does not give Google or Anthropic any access to your content.
## Feature support
For the full feature list with Google Cloud availability, see [Features overview](/docs/en/build-with-claude/overview).
### Supported feature highlights
- [Messages API](/docs/en/api/messages/create)
- [Prompt caching](/docs/en/build-with-claude/prompt-caching)
- [Thinking](/docs/en/build-with-claude/thinking)
- [Tool use](/docs/en/agents-and-tools/tool-use/overview), including the [Bash tool](/docs/en/agents-and-tools/tool-use/bash-tool), [Browser use tool](/docs/en/agents-and-tools/tool-use/browser-use-tool), [Computer use tool](/docs/en/agents-and-tools/tool-use/computer-use-tool), [Memory tool](/docs/en/agents-and-tools/tool-use/memory-tool), and [Text editor tool](/docs/en/agents-and-tools/tool-use/text-editor-tool)
- [Web search tool](/docs/en/agents-and-tools/tool-use/web-search-tool)
- [Citations](/docs/en/build-with-claude/citations)
- [Structured outputs](/docs/en/build-with-claude/structured-outputs)
### Features not supported
- Input sources (URL sources for images and documents, Files API)
- Server-side tools (code execution, web fetch, advisor)
- Agent infrastructure (Agent Skills, MCP connector, programmatic tool calling)
- API endpoints (Message Batches, Models, Admin, Compliance, Usage and Cost)
- Claude Managed Agents
- Server-side fallback (the [`fallbacks` parameter](/docs/en/build-with-claude/refusals-and-fallback#server-side-fallback); use the [client-side fallback pattern](/docs/en/build-with-claude/refusals-and-fallback#client-side-fallback) instead)
### Context window
Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, and Claude Sonnet 4.6 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Agent Platform. Other Claude models, including Sonnet 4.5 and Sonnet 4 (deprecated), have a 200k-token context window.
Agent Platform limits request payloads to 30 MB. When sending large documents or many images, you might reach this limit before the token limit.
## Global, multi-region, and regional endpoints
Agent Platform offers three endpoint types:
- **Global endpoints:** Dynamic routing for maximum availability
- **Multi-region endpoints:** Dynamic routing within a geographic area (for example, the United States or the European Union) for data residency with high availability
- **Regional endpoints:** Guaranteed data routing through specific geographic regions
Regional and multi-region endpoints include a 10% pricing premium over global endpoints.
This applies to Claude Sonnet 4.5 and future models only. Older models (Claude Sonnet 4 (deprecated), Opus 4 (deprecated), and earlier) maintain their existing pricing structures.
### When to use each option
**Global endpoints (recommended):**
- Provide maximum availability and uptime
- Dynamically route requests to regions with available capacity
- No pricing premium
- Best for applications where data residency is flexible
- Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints)
**Multi-region endpoints:**
- Dynamically route requests across regions within a geographic area (currently `us` and `eu`)
- Useful when you need data residency within a broad geography but want higher availability than a single region
- 10% pricing premium over global endpoints
- Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints)
**Regional endpoints:**
- Route traffic through specific geographic regions
- Required for single-region data residency, strict compliance mandates, or provisioned throughput
- Support both pay-as-you-go and provisioned throughput
- 10% pricing premium reflects infrastructure costs for dedicated regional capacity
### Implementation
**Using global endpoints (recommended):**
Set the `region` parameter to `"global"` when initializing the client:
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "global"
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
**Using multi-region endpoints:**
Set the `region` parameter to a multi-region identifier: `"us"` for the United States or `"eu"` for the European Union. The SDK routes requests to the corresponding multi-region endpoint (`https://aiplatform.us.rep.googleapis.com` or `https://aiplatform.eu.rep.googleapis.com`), which dynamically balances traffic across regions within that geography.
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "us" # Multi-region identifier: "us" or "eu"
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
**Using regional endpoints:**
Specify a specific region such as `"us-east5"` or `"europe-west1"`:
cURL
CLI
Python
TypeScript
C#
Go
Java
PHP
Ruby
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "us-east5" # Specify a specific region
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
# Specific regional endpoints support Claude Sonnet 4.6 and earlier; newer models use the global or multi-region endpoints
model="claude-sonnet-4-6",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
Claude Mythos Preview is a research preview available to invited customers on Agent Platform. For more information, see [Project Glasswing](https://anthropic.com/glasswing).
## Additional resources
- **Agent Platform pricing:** [Generative AI pricing on cloud.google.com](https://cloud.google.com/vertex-ai/generative-ai/pricing)
- **Claude models documentation:** [Claude on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude)
- **Google blog post:** [Global endpoint for Claude models](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai)
- **Anthropic pricing details:** [Cloud platform pricing](/docs/en/about-claude/pricing#cloud-platform-pricing)
---
## api-claude-on-vertex-ai.md
# Claude on Vertex AI
Anthropic's Claude models are now generally available through [Vertex AI](https://cloud.google.com/vertex-ai).
The Vertex API for accessing Claude is nearly-identical to the [Messages API](/docs/en/api/messages) and supports all of the same options, with two key differences:
- In Vertex, `model` is not passed in the request body. Instead, it is specified in the Google Cloud endpoint URL.
- In Vertex, `anthropic_version` is passed in the request body (rather than as a header), and must be set to the value `vertex-2023-10-16`.
Vertex is also supported by Anthropic's official [client SDKs](/docs/en/api/client-sdks). This guide walks you through making a request to Claude on Vertex AI using one of Anthropic's client SDKs.
Note that this guide assumes you already have a GCP project that is able to use Vertex AI. See [using the Claude 3 models from Anthropic](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-claude) for more information on the setup required, as well as a full walkthrough.
Install an SDK for accessing Vertex AI
First, install Anthropic's [client SDK](/docs/en/api/client-sdks) for your language of choice.
Python
Python
TypeScript
TypeScript
C#
C#
Go
Go
Java
Java
PHP
PHP
Ruby
Ruby
```python
pip install -U google-cloud-aiplatform "anthropic[vertex]"
```
Accessing Vertex AI
Model availability
Note that Anthropic model availability varies by region. Search for "Claude" in the [Vertex AI Model Garden](https://cloud.google.com/model-garden) or go to [Use Claude 3](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-claude) for the latest information.
API model IDs
| Model | Vertex AI API model ID |
|----------------------|----------------------------|
| Claude Opus 4.6 | claude-opus-4-6 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Sonnet 4.5 | claude-sonnet-4-5@20250929 |
| Claude Sonnet 4 | claude-sonnet-4@20250514 |
| Claude Sonnet 3.7 ⚠️ | claude-3-7-sonnet@20250219 |
| Claude Opus 4.5 | claude-opus-4-5@20251101 |
| Claude Opus 4.1 | claude-opus-4-1@20250805 |
| Claude Opus 4 | claude-opus-4@20250514 |
| Claude Haiku 4.5 | claude-haiku-4-5@20251001 |
| Claude Haiku 3.5 ⚠️ | claude-3-5-haiku@20241022 |
| Claude Haiku 3 ⚠️ | claude-3-haiku@20240307 |
Making requests
Before running requests you may need to run `gcloud auth application-default login` to authenticate with GCP.
The following examples show how to generate text from Claude on Vertex AI:
Shell
```python
MODEL_ID=claude-opus-4-6
LOCATION=global
PROJECT_ID=MY_PROJECT_ID
curl \
-X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://$LOCATION-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${LOCATION}/publishers/anthropic/models/${MODEL_ID}:streamRawPredict -d \
'{
"anthropic_version": "vertex-2023-10-16",
"messages": [{
"role": "user",
"content": "Hey Claude!"
}],
"max_tokens": 100,
}'
```
See the [client SDKs](/docs/en/api/client-sdks) and the official [Vertex AI docs](https://cloud.google.com/vertex-ai/docs) for more details.
Claude is also available through [Amazon Bedrock](/docs/en/build-with-claude/claude-on-amazon-bedrock) and [Microsoft Foundry](/docs/en/build-with-claude/claude-in-microsoft-foundry).
Activity logging
Vertex provides a [request-response logging service](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging) that allows customers to log the prompts and completions associated with your usage.
Anthropic recommends that you log your activity on at least a 30-day rolling basis in order to understand your activity and investigate any potential misuse.
Turning on this service does not give Google or Anthropic any access to your content.
Feature support
For all currently supported features on Vertex AI, see [API features overview](/docs/en/api/overview).
Context window
Claude Opus 4.6, Sonnet 4.6, Sonnet 4.5, and Sonnet 4 have a [1M-token context window](/docs/en/build-with-claude/context-windows) on Vertex AI.
For Claude Sonnet 4.5 and Sonnet 4, the 1M-token context window is in beta. To use, include the `context-1m-2025-08-07` [beta header](/docs/en/api/beta-headers) in your API requests.
Vertex AI limits request payloads to 30 MB. When sending large documents or many images, you may reach this limit before the token limit.
Global vs regional endpoints
Starting with **Claude Sonnet 4.5 and all future models**, Google Vertex AI offers two endpoint types:
- **Global endpoints:** Dynamic routing for maximum availability
- **Regional endpoints:** Guaranteed data routing through specific geographic regions
Regional endpoints include a 10% pricing premium over global endpoints.
This applies to Claude Sonnet 4.5 and future models only. Older models (Claude Sonnet 4, Opus 4, and earlier) maintain their existing pricing structures.
When to use each option
**Global endpoints (recommended):**
- Provide maximum availability and uptime
- Dynamically route requests to regions with available capacity
- No pricing premium
- Best for applications where data residency is flexible
- Only supports pay-as-you-go traffic (provisioned throughput requires regional endpoints)
**Regional endpoints:**
- Route traffic through specific geographic regions
- Required for data residency and compliance requirements
- Support both pay-as-you-go and provisioned throughput
- 10% pricing premium reflects infrastructure costs for dedicated regional capacity
Implementation
**Using global endpoints (recommended):**
Set the `region` parameter to `"global"` when initializing the client:
Python
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "global"
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-4-6",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
**Using regional endpoints:**
Specify a specific region like `"us-east1"` or `"europe-west1"`:
Python
```python
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "us-east1" # Specify a specific region
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-4-6",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)
```
Additional resources
- **Google Vertex AI pricing:** [cloud.google.com/vertex-ai/generative-ai/pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing)
- **Claude models documentation:** [Claude on Vertex AI](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/claude)
- **Google blog post:** [Global endpoint for Claude models](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai)
- **Anthropic pricing details:** [Pricing documentation](/docs/en/about-claude/pricing#third-party-platform-pricing)
---
## api-claude-platform-on-aws-iam-actions-46a81874e2.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fclaude-platform-on-aws-iam-actions)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
[API reference](/docs/en/api/overview)Support & configuration
# IAM actions for Claude Platform on AWS
Copy page
IAM action reference for controlling access to Claude Platform on AWS through AWS policies.
Copy page
Claude Platform on AWS uses AWS IAM for access control. Every API route maps to an IAM action in the `aws-external-anthropic` namespace. This page lists all actions, the routes each action authorizes, and the managed policies available for common access patterns. For platform setup and authentication, see [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws).
## Service details
| Attribute | Value |
|:-----------------------|:-------------------------|
| **IAM service prefix** | `aws-external-anthropic` |
| **Resource types** | `workspace` |
Workspace ARN format:
``` block
arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}
```
The ARN region is always populated and matches the region the workspace is bound to. The resource segment is the tagged workspace ID (`wrkspc_...`), the same value you pass in the `anthropic-workspace-id` header.
## Actions
The service defines 71 actions. Actions follow the AWS `VerbNoun` convention and use verb discipline so that `Get*` and `List*` wildcards produce a clean read-only boundary.
### Inference
| Action | Routes authorized |
|:------------------|:---------------------------------|
| `CreateInference` | `POST /v1/messages` |
| `CountTokens` | `POST /v1/messages/count_tokens` |
### Batch processing
[TABLE]
`GetBatchInference` authorizes both reading batch metadata and downloading batch results. The `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, and `AnthropicLimitedAccess` policies' `Get*` wildcards include this action.
### Models
| Action | Routes authorized |
|:-------------|:----------------------|
| `GetModel` | `GET /v1/models/{id}` |
| `ListModels` | `GET /v1/models` |
### Files
[TABLE]
`GetFile` authorizes both metadata and content download. A principal with read-only access can download file bytes, not just list files.
### Skills
[TABLE]
`GetSkill` authorizes both skill metadata and skill-content download. A principal with read-only access can download skill bytes, not just list skills.
Creating or deleting an individual skill version maps to `UpdateSkill`, not `CreateSkill` or `DeleteSkill`. A policy that denies `aws-external-anthropic:Delete*` still allows version deletion, and a policy that denies `aws-external-anthropic:Create*` still allows version creation. Deny `UpdateSkill` and `CreateSkill` as well if you need to prevent any skill mutation.
### Agents
[TABLE]
Agents support only archive, not hard delete. A policy that denies `aws-external-anthropic:Delete*` does not block `ArchiveAgent`. Deny `ArchiveAgent`, `UpdateAgent`, and `CreateAgent` if you need to prevent any agent mutation.
### Sessions
[TABLE]
`GetSession` authorizes reading session metadata, the full event stream (conversation history), and session resources. The `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, and `AnthropicLimitedAccess` policies' `Get*` wildcards include this action.
Creating, updating, or deleting an individual session sub-resource (events or session resources) maps to `UpdateSession`, not `CreateSession` or `DeleteSession`. A policy that denies `aws-external-anthropic:Delete*` still allows sub-resource deletion, and a policy that denies `aws-external-anthropic:Create*` still allows sub-resource creation. Deny `UpdateSession`, `CreateSession`, and `ArchiveSession` as well if you need to prevent any session mutation.
### Environments
[TABLE]
A policy that denies `aws-external-anthropic:Delete*` does not block `ArchiveEnvironment`. `ProcessEnvironmentWork` is not matched by `Create*`, `Update*`, `Delete*`, or `Archive*` wildcards. Deny `ArchiveEnvironment`, `UpdateEnvironment`, `CreateEnvironment`, and `ProcessEnvironmentWork` as well if you need to prevent any environment mutation.
`ProcessEnvironmentWork` authorizes a [self-hosted sandbox](/docs/en/managed-agents/self-hosted-sandboxes) worker to poll for, acknowledge, heartbeat, stop, and post results on environment work items. Grant it only to principals that run self-hosted environment workers. The `AnthropicSelfHostedEnvironmentAccess` managed policy includes this action.
### Vaults
[TABLE]
Creating, updating, archiving, or deleting an individual vault credential maps to `UpdateVault`. Reading a credential maps to `GetVault`. Vault credential secrets are not exposed: secret fields are write-only and are never returned by `GetVault` (see [Authenticate with vaults](/docs/en/managed-agents/vaults)). A policy that denies `aws-external-anthropic:Delete*` still allows credential deletion, and a policy that denies `aws-external-anthropic:Create*` still allows credential creation. Deny `UpdateVault`, `CreateVault`, and `ArchiveVault` as well if you need to prevent any vault mutation.
### Memory stores
[TABLE]
`GetMemoryStore` authorizes reading store metadata, all memories, and memory version history. The `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, and `AnthropicLimitedAccess` policies' `Get*` wildcards include this action.
Creating, updating, or deleting an individual memory and redacting a memory version both map to `UpdateMemoryStore`, not `CreateMemoryStore` or `DeleteMemoryStore`. A policy that denies `aws-external-anthropic:Delete*` still allows individual-memory deletion and memory-version redaction, and a policy that denies `aws-external-anthropic:Create*` still allows individual-memory creation. Deny `UpdateMemoryStore`, `CreateMemoryStore`, and `ArchiveMemoryStore` as well if you need to prevent any memory-store mutation.
### Webhooks
| Action | Routes authorized |
|:----------------------|:---------------------------------------------------|
| `CreateWebhook` | `POST /v1/webhooks` |
| `GetWebhook` | `GET /v1/webhooks/{id}` |
| `ListWebhooks` | `GET /v1/webhooks` |
| `UpdateWebhook` | `POST /v1/webhooks/{id}` |
| `DeleteWebhook` | `DELETE /v1/webhooks/{id}` |
| `RotateWebhookSecret` | `POST /v1/webhooks/{id}/regenerate_signing_secret` |
Webhook signing secrets are write-only. `GetWebhook` returns webhook metadata only; it does not return the signing secret.
`RotateWebhookSecret` is not matched by `aws-external-anthropic:Create*`, `Update*`, or `Delete*` wildcards. A policy that denies those patterns still allows secret rotation. Deny `RotateWebhookSecret`, `UpdateWebhook`, `CreateWebhook`, and `DeleteWebhook` if you need to prevent any webhook mutation.
### User profiles
| Action | Routes authorized |
|:--------------------|:------------------------------|
| `CreateUserProfile` | `POST /v1/user_profiles` |
| `GetUserProfile` | `GET /v1/user_profiles/{id}` |
| `ListUserProfiles` | `GET /v1/user_profiles` |
| `UpdateUserProfile` | `POST /v1/user_profiles/{id}` |
IAM action matching is case-insensitive. The wildcard `aws-external-anthropic:*File` matches `CreateFile`, `GetFile`, and `DeleteFile`, but does not match `ListFiles` (which ends in "files", not "file"). It also over-matches `CreateUserProfile`, `GetUserProfile`, and `UpdateUserProfile` because "Profile" ends in "file". If you intend to grant or deny only Files API actions, enumerate them explicitly (`CreateFile`, `GetFile`, `ListFiles`, `DeleteFile`) rather than using a `*File` suffix pattern.
### Workspaces
| Action | Routes authorized |
|:-------------------|:-------------------------------------------------|
| `CreateWorkspace` | `POST /v1/organizations/workspaces` |
| `GetWorkspace` | `GET /v1/organizations/workspaces/{id}` |
| `ListWorkspaces` | `GET /v1/organizations/workspaces` |
| `UpdateWorkspace` | `POST /v1/organizations/workspaces/{id}` |
| `ArchiveWorkspace` | `POST /v1/organizations/workspaces/{id}/archive` |
Workspaces support only archive, not hard delete. A policy that denies `aws-external-anthropic:Delete*` does not block `ArchiveWorkspace`. Deny `ArchiveWorkspace`, `UpdateWorkspace`, and `CreateWorkspace` if you need to prevent any workspace mutation.
### Encryption keys
| Action | Routes authorized |
|:--------------|:----------------------------------------------|
| `RegisterKey` | `POST /v1/organizations/external_keys` |
| `GetKey` | `GET /v1/organizations/external_keys/{id}` |
| `ListKeys` | `GET /v1/organizations/external_keys` |
| `UpdateKey` | `POST /v1/organizations/external_keys/{id}` |
| `DisableKey` | `DELETE /v1/organizations/external_keys/{id}` |
These actions manage your organization's [customer-managed encryption key (CMEK)](/docs/en/manage-claude/cmek-aws-kms#claude-platform-on-aws) registrations, the record of which AWS KMS key ARNs are registered. They do not create, change, or disable the keys in AWS KMS. `DisableKey` removes a registration and is rejected while any workspace still uses the key. `RegisterKey` and `DisableKey` are not matched by `Create*`, `Update*`, or `Delete*` wildcards; deny `RegisterKey`, `UpdateKey`, and `DisableKey` if you need to prevent any change to key registrations. In these routes, `{id}` is the URL-encoded KMS key ARN. Attaching a registered key to a workspace is a workspace operation, authorized by `CreateWorkspace` or `UpdateWorkspace`; the principal that attaches a key also needs `kms:DescribeKey`, `kms:Encrypt`, and `kms:Decrypt` on that key (see the [prerequisites](/docs/en/manage-claude/cmek-aws-kms#claude-platform-on-aws)). External key actions are account-scoped: specifying a workspace ARN on them has no effect; use `Resource: "*"`.
### Compliance
| Action | Routes authorized |
|:---------------------------|:--------------------------------|
| `ListComplianceActivities` | `GET /v1/compliance/activities` |
`ListComplianceActivities` authorizes reading the [Compliance API](/docs/en/manage-claude/compliance-api) [Activity Feed](/docs/en/manage-claude/compliance-activity-feed), the organization-wide audit log that includes access transparency events. The route returns an error until the Compliance API is [enabled for your organization](/docs/en/manage-claude/compliance-api-access); enablement is on request through your Anthropic account team. The `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, and `AnthropicLimitedAccess` policies' `List*` wildcards include this action.
`ListComplianceActivities` is account-scoped, like `ListWorkspaces`. Specifying a workspace ARN on this action has no effect; use `Resource: "*"`.
### Authentication
| Action | Routes authorized |
|:----------------------|:------------------|
| `CallWithBearerToken` | (none) |
`CallWithBearerToken` is an authentication-layer permission that authorizes a principal to authenticate through an API key (bearer token) rather than AWS SigV4. It does not map to a route. Grant it alongside the route-mapped actions you want the API key holder to perform.
### Console access
| Action | Routes authorized |
|:----------------|:------------------|
| `AssumeConsole` | (none) |
`AssumeConsole` authorizes a principal to open the Claude Console for a Claude Platform on AWS workspace through the AWS Console federation flow. It does not map to a route. Grant it to principals who should be able to click **Open Claude Console** on the Claude Platform on AWS service page in the AWS Console. The Claude Console role (Admin or Developer) is assigned separately by your Anthropic account representative; it is not derived from the principal's IAM permissions. See [Using the Claude Console](/docs/en/build-with-claude/claude-platform-on-aws#using-the-claude-console) for the sign-in flow and role descriptions.
## Route-to-action mapping
The following table lists every route on Claude Platform on AWS and the IAM action required to call it. Each IAM action also authorizes requests that use the `anthropic-beta` header; beta variants of a route do not require a separate IAM action. CloudTrail classifies each action as either a Data event (high-volume, data-plane operations) or a Management event (control-plane operations). Vault and webhook actions are classified as Management events because they hold secrets (vault credentials and webhook signing secrets) and benefit from default-on audit logging. Workspace, external key, and compliance actions are also classified as Management events because they are organization-scoped control-plane operations. All other actions, including inference, batch, model, file, skill, user profile, and the remaining Claude Managed Agents actions, are classified as Data events.
| Method | Route | IAM action | CloudTrail event type |
|:---------|:-----------------------------------------------------|:---------------------------|:----------------------|
| `POST` | `/v1/messages` | `CreateInference` | Data |
| `POST` | `/v1/messages/count_tokens` | `CountTokens` | Data |
| `POST` | `/v1/messages/batches` | `CreateBatchInference` | Data |
| `GET` | `/v1/messages/batches` | `ListBatchInferences` | Data |
| `GET` | `/v1/messages/batches/{id}` | `GetBatchInference` | Data |
| `GET` | `/v1/messages/batches/{id}/results` | `GetBatchInference` | Data |
| `POST` | `/v1/messages/batches/{id}/cancel` | `CancelBatchInference` | Data |
| `DELETE` | `/v1/messages/batches/{id}` | `DeleteBatchInference` | Data |
| `GET` | `/v1/models` | `ListModels` | Data |
| `GET` | `/v1/models/{id}` | `GetModel` | Data |
| `POST` | `/v1/files` | `CreateFile` | Data |
| `GET` | `/v1/files` | `ListFiles` | Data |
| `GET` | `/v1/files/{id}` | `GetFile` | Data |
| `GET` | `/v1/files/{id}/content` | `GetFile` | Data |
| `DELETE` | `/v1/files/{id}` | `DeleteFile` | Data |
| `POST` | `/v1/skills` | `CreateSkill` | Data |
| `GET` | `/v1/skills` | `ListSkills` | Data |
| `GET` | `/v1/skills/{id}` | `GetSkill` | Data |
| `DELETE` | `/v1/skills/{id}` | `DeleteSkill` | Data |
| `POST` | `/v1/skills/{id}/versions` | `UpdateSkill` | Data |
| `GET` | `/v1/skills/{id}/versions` | `GetSkill` | Data |
| `GET` | `/v1/skills/{id}/versions/{version}` | `GetSkill` | Data |
| `GET` | `/v1/skills/{id}/versions/{version}/content` | `GetSkill` | Data |
| `DELETE` | `/v1/skills/{id}/versions/{version}` | `UpdateSkill` | Data |
| `POST` | `/v1/user_profiles` | `CreateUserProfile` | Data |
| `GET` | `/v1/user_profiles` | `ListUserProfiles` | Data |
| `GET` | `/v1/user_profiles/{id}` | `GetUserProfile` | Data |
| `POST` | `/v1/user_profiles/{id}` | `UpdateUserProfile` | Data |
| `POST` | `/v1/organizations/workspaces` | `CreateWorkspace` | Management |
| `GET` | `/v1/organizations/workspaces` | `ListWorkspaces` | Management |
| `GET` | `/v1/organizations/workspaces/{id}` | `GetWorkspace` | Management |
| `POST` | `/v1/organizations/workspaces/{id}` | `UpdateWorkspace` | Management |
| `POST` | `/v1/organizations/workspaces/{id}/archive` | `ArchiveWorkspace` | Management |
| `POST` | `/v1/organizations/external_keys` | `RegisterKey` | Management |
| `GET` | `/v1/organizations/external_keys` | `ListKeys` | Management |
| `GET` | `/v1/organizations/external_keys/{id}` | `GetKey` | Management |
| `POST` | `/v1/organizations/external_keys/{id}` | `UpdateKey` | Management |
| `DELETE` | `/v1/organizations/external_keys/{id}` | `DisableKey` | Management |
| `GET` | `/v1/compliance/activities` | `ListComplianceActivities` | Management |
| `POST` | `/v1/agents` | `CreateAgent` | Data |
| `GET` | `/v1/agents` | `ListAgents` | Data |
| `GET` | `/v1/agents/{id}` | `GetAgent` | Data |
| `POST` | `/v1/agents/{id}` | `UpdateAgent` | Data |
| `POST` | `/v1/agents/{id}/archive` | `ArchiveAgent` | Data |
| `GET` | `/v1/agents/{id}/versions` | `GetAgent` | Data |
| `POST` | `/v1/sessions` | `CreateSession` | Data |
| `GET` | `/v1/sessions` | `ListSessions` | Data |
| `GET` | `/v1/sessions/{id}` | `GetSession` | Data |
| `POST` | `/v1/sessions/{id}` | `UpdateSession` | Data |
| `POST` | `/v1/sessions/{id}/archive` | `ArchiveSession` | Data |
| `DELETE` | `/v1/sessions/{id}` | `DeleteSession` | Data |
| `GET` | `/v1/sessions/{id}/events` | `GetSession` | Data |
| `POST` | `/v1/sessions/{id}/events` | `UpdateSession` | Data |
| `GET` | `/v1/sessions/{id}/events/stream` | `GetSession` | Data |
| `GET` | `/v1/sessions/{id}/resources` | `GetSession` | Data |
| `GET` | `/v1/sessions/{id}/resources/{id}` | `GetSession` | Data |
| `POST` | `/v1/sessions/{id}/resources` | `UpdateSession` | Data |
| `POST` | `/v1/sessions/{id}/resources/{id}` | `UpdateSession` | Data |
| `DELETE` | `/v1/sessions/{id}/resources/{id}` | `UpdateSession` | Data |
| `POST` | `/v1/environments` | `CreateEnvironment` | Data |
| `GET` | `/v1/environments` | `ListEnvironments` | Data |
| `GET` | `/v1/environments/{id}` | `GetEnvironment` | Data |
| `POST` | `/v1/environments/{id}` | `UpdateEnvironment` | Data |
| `POST` | `/v1/environments/{id}/archive` | `ArchiveEnvironment` | Data |
| `DELETE` | `/v1/environments/{id}` | `DeleteEnvironment` | Data |
| `GET` | `/v1/environments/{id}/work` | `GetEnvironment` | Data |
| `GET` | `/v1/environments/{id}/work/poll` | `ProcessEnvironmentWork` | Data |
| `GET` | `/v1/environments/{id}/work/{work_id}` | `GetEnvironment` | Data |
| `GET` | `/v1/environments/{id}/work/stats` | `GetEnvironment` | Data |
| `POST` | `/v1/environments/{id}/work/{work_id}` | `ProcessEnvironmentWork` | Data |
| `POST` | `/v1/environments/{id}/work/{work_id}/ack` | `ProcessEnvironmentWork` | Data |
| `POST` | `/v1/environments/{id}/work/{work_id}/heartbeat` | `ProcessEnvironmentWork` | Data |
| `POST` | `/v1/environments/{id}/work/{work_id}/stop` | `ProcessEnvironmentWork` | Data |
| `POST` | `/v1/vaults` | `CreateVault` | Management |
| `GET` | `/v1/vaults` | `ListVaults` | Management |
| `GET` | `/v1/vaults/{id}` | `GetVault` | Management |
| `POST` | `/v1/vaults/{id}` | `UpdateVault` | Management |
| `POST` | `/v1/vaults/{id}/archive` | `ArchiveVault` | Management |
| `DELETE` | `/v1/vaults/{id}` | `DeleteVault` | Management |
| `GET` | `/v1/vaults/{id}/credentials` | `GetVault` | Management |
| `POST` | `/v1/vaults/{id}/credentials` | `UpdateVault` | Management |
| `GET` | `/v1/vaults/{id}/credentials/{id}` | `GetVault` | Management |
| `POST` | `/v1/vaults/{id}/credentials/{id}` | `UpdateVault` | Management |
| `POST` | `/v1/vaults/{id}/credentials/{id}/archive` | `UpdateVault` | Management |
| `DELETE` | `/v1/vaults/{id}/credentials/{id}` | `UpdateVault` | Management |
| `POST` | `/v1/memory_stores` | `CreateMemoryStore` | Data |
| `GET` | `/v1/memory_stores` | `ListMemoryStores` | Data |
| `GET` | `/v1/memory_stores/{id}` | `GetMemoryStore` | Data |
| `POST` | `/v1/memory_stores/{id}` | `UpdateMemoryStore` | Data |
| `POST` | `/v1/memory_stores/{id}/archive` | `ArchiveMemoryStore` | Data |
| `DELETE` | `/v1/memory_stores/{id}` | `DeleteMemoryStore` | Data |
| `POST` | `/v1/memory_stores/{id}/memories` | `UpdateMemoryStore` | Data |
| `GET` | `/v1/memory_stores/{id}/memories` | `GetMemoryStore` | Data |
| `GET` | `/v1/memory_stores/{id}/memories/{id}` | `GetMemoryStore` | Data |
| `POST` | `/v1/memory_stores/{id}/memories/{id}` | `UpdateMemoryStore` | Data |
| `DELETE` | `/v1/memory_stores/{id}/memories/{id}` | `UpdateMemoryStore` | Data |
| `GET` | `/v1/memory_stores/{id}/memory_versions` | `GetMemoryStore` | Data |
| `GET` | `/v1/memory_stores/{id}/memory_versions/{id}` | `GetMemoryStore` | Data |
| `POST` | `/v1/memory_stores/{id}/memory_versions/{id}/redact` | `UpdateMemoryStore` | Data |
| `GET` | `/v1/webhooks` | `ListWebhooks` | Management |
| `GET` | `/v1/webhooks/{id}` | `GetWebhook` | Management |
| `POST` | `/v1/webhooks` | `CreateWebhook` | Management |
| `POST` | `/v1/webhooks/{id}` | `UpdateWebhook` | Management |
| `DELETE` | `/v1/webhooks/{id}` | `DeleteWebhook` | Management |
| `POST` | `/v1/webhooks/{id}/regenerate_signing_secret` | `RotateWebhookSecret` | Management |
Routes not in this table are not available on Claude Platform on AWS. The gateway denies any route not listed here by default.
Workspace and external key routes are the only Admin API routes available on Claude Platform on AWS. You can also create, update, or archive workspaces in the AWS Console or, with the Admin role, in the Claude Console. Encryption keys can also be registered and attached in the Claude Console.
## Managed policies
AWS provides five managed policies for Claude Platform on AWS. All managed policies apply to `Resource: "*"`.
| Policy | Grants |
|:---------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `AnthropicFullAccess` | `aws-external-anthropic:*` |
| `AnthropicReadOnlyAccess` | `Get*`, `List*`, `CallWithBearerToken` |
| `AnthropicInferenceAccess` | `Get*`, `List*`, `CreateInference`, `CreateBatchInference`, `CancelBatchInference`, `DeleteBatchInference`, `CountTokens`, `CallWithBearerToken` |
| `AnthropicLimitedAccess` | All `AnthropicInferenceAccess` actions, plus all Claude Managed Agents actions (agents, sessions, environments, vaults, memory stores, webhooks, and self-hosted environment work) |
| `AnthropicSelfHostedEnvironmentAccess` | `GetEnvironment`, `ProcessEnvironmentWork`, `GetSession`, `UpdateSession`, `GetSkill`, `CallWithBearerToken` |
`AnthropicInferenceAccess` is the narrowest managed policy sufficient to run inference. It covers both synchronous and batch inference and, through the `Get*` and `List*` wildcards, grants read access to every API resource in the namespace, including Claude Managed Agents (CMA) resources (agents, sessions, environments, vaults, memory stores, and webhooks). This includes file content download through `GetFile` (see the [Files](#files) note), skill content download through `GetSkill` (see the [Skills](#skills) note), and memory contents through `GetMemoryStore`. Vault credential secrets and webhook signing secrets are not exposed: those fields are write-only and are never returned by `GetVault` or `GetWebhook` (see [Authenticate with vaults](/docs/en/managed-agents/vaults)). `AnthropicInferenceAccess` does not grant file creation or deletion, skill management, user profile management, workspace mutation, encryption key management, or any Claude Managed Agents write action (create, update, archive, delete, process, or rotate). To exclude CMA reads, replace `AnthropicInferenceAccess` with a custom policy that enumerates only the specific non-CMA actions you need.
`AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, and `AnthropicLimitedAccess` all carry the `Get*` and `List*` wildcards, which grant read access to all content in the workspace: file bytes, skill content, batch results, session conversation history, and memory contents. The wildcards also grant `GetKey` and `ListKeys`, which read the organization's registered encryption key configurations (key ARNs and metadata, never key material). The `List*` wildcard also grants `ListComplianceActivities`, which reads the organization's compliance [Activity Feed](/docs/en/manage-claude/compliance-activity-feed) once the Compliance API is enabled for the organization (see [Compliance](#compliance)). Vault credential secrets and webhook signing secrets are not exposed; those fields are write-only and are never returned by `GetVault` or `GetWebhook`. If your principal should not read existing content, use a custom policy that enumerates only the actions you need.
`AnthropicLimitedAccess` includes all Claude Managed Agents actions in addition to inference actions.
`AnthropicSelfHostedEnvironmentAccess` is the narrowest managed policy sufficient to run a [self-hosted sandbox](/docs/en/managed-agents/self-hosted-sandboxes) worker. Attach it to the principal your environment worker authenticates as.
`AssumeConsole` is not included in `AnthropicReadOnlyAccess`, `AnthropicInferenceAccess`, `AnthropicLimitedAccess`, or `AnthropicSelfHostedEnvironmentAccess`. Principals who need Claude Console access require either `AnthropicFullAccess` or a custom policy that grants `aws-external-anthropic:AssumeConsole`. See [Console access](#console-access).
`CreateInference` and `CreateBatchInference` are separate actions. Denying one does not block the other. If you intend to prevent all model calls, deny both.
## Example policies
### Synchronous inference on a single workspace
Grants the minimal permissions for an IAM principal that runs inference against one production workspace:
```python
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CreateInference",
"aws-external-anthropic:CountTokens",
"aws-external-anthropic:GetModel",
"aws-external-anthropic:ListModels",
"aws-external-anthropic:GetWorkspace"
],
"Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
}
]
}
```
`ListWorkspaces` is account-scoped (see [Provisioning automation](#provisioning-automation)). If your service account needs to enumerate workspaces, add a separate `Allow` statement for `ListWorkspaces` with `Resource: "*"`.
This policy assumes AWS SigV4 authentication. If the principal authenticates with an API key, add a separate `Allow` statement for `aws-external-anthropic:CallWithBearerToken` with `Resource: "*"`. `CallWithBearerToken` is a route-less action that does not bind to a workspace ARN. See [Per-customer workspace isolation](#per-customer-workspace-isolation) for the two-statement pattern.
### Per-customer workspace isolation
Restricts a role to a single workspace:
```python
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "aws-external-anthropic:*",
"Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
},
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CallWithBearerToken",
"aws-external-anthropic:AssumeConsole"
],
"Resource": "*"
}
]
}
```
The `aws-external-anthropic:*` wildcard in the first statement includes account-scoped actions (`CreateWorkspace`, `ListWorkspaces`, `ListComplianceActivities`, and the external key actions) that the workspace ARN constraint silently filters out. This is consistent with the "isolation" intent (the role cannot create workspaces, enumerate workspaces, manage encryption key registrations, or read the compliance Activity Feed; it can still attach an already-registered key to its own workspace through `UpdateWorkspace`), but the policy contains permissions that have no effect. See [Provisioning automation](#provisioning-automation) for the account-scoped pattern.
`CallWithBearerToken` and `AssumeConsole` are route-less actions that do not bind to a workspace ARN. The second statement grants them on `Resource: "*"` so the role can authenticate with an API key and open the Claude Console. Omit this statement if the role uses SigV4 only and does not need Claude Console access.
### Feature lockdown for a ZDR-sensitive workspace
Blocks batch processing and file upload on a specific workspace while leaving synchronous inference available. Useful when a workspace handles [Zero Data Retention (ZDR)](/docs/en/manage-claude/api-and-data-retention) data that must not persist server-side. Attach this policy alongside an Allow policy such as `AnthropicInferenceAccess` or the [single-workspace example](#synchronous-inference-on-a-single-workspace); on its own, a Deny-only policy grants no permissions:
```python
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": [
"aws-external-anthropic:CreateBatchInference",
"aws-external-anthropic:CreateFile"
],
"Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
}
]
}
```
This deny blocks creation only. Other file and batch actions are not denied unless you list them as well. For a complete lockdown where the workspace must never hold files or batches, also deny `aws-external-anthropic:GetFile`, `aws-external-anthropic:ListFiles`, `aws-external-anthropic:DeleteFile`, `aws-external-anthropic:GetBatchInference`, `aws-external-anthropic:ListBatchInferences`, `aws-external-anthropic:CancelBatchInference`, and `aws-external-anthropic:DeleteBatchInference`.
### Provisioning automation
Besides the Admin API, you can create, update, or archive workspaces in the AWS Console or, with the Admin role, in the Claude Console.
Grants a CI/CD role the actions needed to create and manage workspaces, without any inference permissions:
```python
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CreateWorkspace",
"aws-external-anthropic:GetWorkspace",
"aws-external-anthropic:ListWorkspaces",
"aws-external-anthropic:UpdateWorkspace",
"aws-external-anthropic:ArchiveWorkspace"
],
"Resource": "*"
}
]
}
```
`CreateWorkspace` and `ListWorkspaces` are account-scoped operations. Specifying a workspace ARN on these actions has no effect; use `Resource: "*"`.
## See also
- [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws) for setup, authentication, and platform overview
- [AWS IAM User Guide](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) for IAM policy syntax and evaluation logic
- [AWS CloudTrail User Guide](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/) for audit logging configuration
---
## api-cli-beta-models-385ff34a98.md
# Models
## List
`$ ant beta:models list`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `--after-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `--before-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `--limit: optional number`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `--beta: optional array of AnthropicBeta`
Header param: Optional header to specify the beta version(s) you want to use.
### Returns
- `BetaListResponse_ModelInfo_: object { data, first_id, has_more, last_id }`
- `data: array of BetaModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```cli
ant beta:models list \
--api-key my-anthropic-api-key
```
## Retrieve
`$ ant beta:models retrieve`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `--model-id: string`
Model identifier or alias.
- `--beta: optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
### Returns
- `beta_model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Example
```cli
ant beta:models retrieve \
--api-key my-anthropic-api-key \
--model-id model_id
```
## Domain Types
### Beta Capability Support
- `beta_capability_support: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Context Management Capability
- `beta_context_management_capability: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management capability details.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Effort Capability
- `beta_effort_capability: object { high, low, max, 2 more }`
Effort (reasoning_effort) capability details.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Model Capabilities
- `beta_model_capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Model Info
- `beta_model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Beta Thinking Capability
- `beta_thinking_capability: object { supported, types }`
Thinking capability details.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Beta Thinking Types
- `beta_thinking_types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
---
## api-cli-beta-models-list-5ec77a878a.md
## List
`$ ant beta:models list`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `--after-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `--before-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `--limit: optional number`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `--beta: optional array of AnthropicBeta`
Header param: Optional header to specify the beta version(s) you want to use.
### Returns
- `BetaListResponse_ModelInfo_: object { data, first_id, has_more, last_id }`
- `data: array of BetaModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```cli
ant beta:models list \
--api-key my-anthropic-api-key
```
---
## api-cli-beta-models-list.md
---
## api-cli-beta-models-retrieve-dbbcb4692a.md
## Retrieve
`$ ant beta:models retrieve`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `--model-id: string`
Model identifier or alias.
- `--beta: optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
### Returns
- `beta_model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Example
```cli
ant beta:models retrieve \
--api-key my-anthropic-api-key \
--model-id model_id
```
---
## api-cli-beta-models-retrieve.md
---
## api-cli-models-3936ae0c6e.md
# Models
## List
`$ ant models list`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `--after-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `--before-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `--limit: optional number`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `--beta: optional array of AnthropicBeta`
Header param: Optional header to specify the beta version(s) you want to use.
### Returns
- `ListResponse_ModelInfo_: object { data, first_id, has_more, last_id }`
- `data: array of ModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```cli
ant models list \
--api-key my-anthropic-api-key
```
## Retrieve
`$ ant models retrieve`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `--model-id: string`
Model identifier or alias.
- `--beta: optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
### Returns
- `model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Example
```cli
ant models retrieve \
--api-key my-anthropic-api-key \
--model-id model_id
```
## Domain Types
### Capability Support
- `capability_support: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
### Context Management Capability
- `context_management_capability: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management capability details.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Effort Capability
- `effort_capability: object { high, low, max, 2 more }`
Effort (reasoning_effort) capability details.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Model Capabilities
- `model_capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Model Info
- `model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Thinking Capability
- `thinking_capability: object { supported, types }`
Thinking capability details.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Thinking Types
- `thinking_types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
---
## api-cli-models-list-e974eb8808.md
## List
`$ ant models list`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `--after-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `--before-id: optional string`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `--limit: optional number`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `--beta: optional array of AnthropicBeta`
Header param: Optional header to specify the beta version(s) you want to use.
### Returns
- `ListResponse_ModelInfo_: object { data, first_id, has_more, last_id }`
- `data: array of ModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```cli
ant models list \
--api-key my-anthropic-api-key
```
---
## api-cli-models-list.md
---
## api-cli-models-retrieve-88d62a2309.md
## Retrieve
`$ ant models retrieve`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `--model-id: string`
Model identifier or alias.
- `--beta: optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
### Returns
- `model_info: object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: object { supported }`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: object { supported }`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: object { supported }`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management support and available strategies.
- `clear_thinking_20251015: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: object { high, low, max, 2 more }`
Effort (reasoning_effort) support and available levels.
- `high: object { supported }`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: object { supported }`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: object { supported }`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: object { supported }`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: object { supported }`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: object { supported }`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: object { supported }`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: object { supported, types }`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: object { supported }`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: object { supported }`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
### Example
```cli
ant models retrieve \
--api-key my-anthropic-api-key \
--model-id model_id
```
---
## api-cli-models-retrieve.md
---
## api-cli-models.md
---
## api-csharp-beta-models-bebc8508a9.md
# Models
## List
`ModelListPageResponse Beta.Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams parameters`
- `string afterID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `string beforeID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Long limit`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `IReadOnlyList betas`
Header param: Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelListPageResponse:`
- `required IReadOnlyList Data`
- `required string ID`
Unique model identifier.
- `required BetaModelCapabilities? Capabilities`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
- `required string? FirstID`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `required Boolean HasMore`
Indicates if there are more results in the requested page direction.
- `required string? LastID`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```csharp
ModelListParams parameters = new();
var page = await client.Beta.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
## Retrieve
`BetaModelInfo Beta.Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams parameters`
- `required string modelID`
Model identifier or alias.
- `IReadOnlyList betas`
Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class BetaModelInfo:`
- `required string ID`
Unique model identifier.
- `required BetaModelCapabilities? Capabilities`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Example
```csharp
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var betaModelInfo = await client.Beta.Models.Retrieve(parameters);
Console.WriteLine(betaModelInfo);
```
## Domain Types
### Beta Capability Support
- `class BetaCapabilitySupport:`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Beta Context Management Capability
- `class BetaContextManagementCapability:`
Context management capability details.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Beta Effort Capability
- `class BetaEffortCapability:`
Effort (reasoning_effort) capability details.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Beta Model Capabilities
- `class BetaModelCapabilities:`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Beta Model Info
- `class BetaModelInfo:`
- `required string ID`
Unique model identifier.
- `required BetaModelCapabilities? Capabilities`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Beta Thinking Capability
- `class BetaThinkingCapability:`
Thinking capability details.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Beta Thinking Types
- `class BetaThinkingTypes:`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
---
## api-csharp-beta-models-list-b1924f15f6.md
## List
`ModelListPageResponse Beta.Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams parameters`
- `string afterID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `string beforeID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Long limit`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `IReadOnlyList betas`
Header param: Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelListPageResponse:`
- `required IReadOnlyList Data`
- `required string ID`
Unique model identifier.
- `required BetaModelCapabilities? Capabilities`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
- `required string? FirstID`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `required Boolean HasMore`
Indicates if there are more results in the requested page direction.
- `required string? LastID`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```csharp
ModelListParams parameters = new();
var page = await client.Beta.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
---
## api-csharp-beta-models-list.md
# List Models
[ModelListPageResponse](/docs/en/api/beta#ModelListPageResponse) Beta.Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
ModelListParams parameters
string afterID
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
string beforeID
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Long limit
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
IReadOnlyList\<[AnthropicBeta](/docs/en/api/beta#anthropic_beta)\> betas
Header param: Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"MessageBatches2024_09_24
"prompt-caching-2024-07-31"PromptCaching2024_07_31
"computer-use-2024-10-22"ComputerUse2024_10_22
"computer-use-2025-01-24"ComputerUse2025_01_24
"pdfs-2024-09-25"Pdfs2024_09_25
"token-counting-2024-11-01"TokenCounting2024_11_01
"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19
"output-128k-2025-02-19"Output128k2025_02_19
"files-api-2025-04-14"FilesApi2025_04_14
"mcp-client-2025-04-04"McpClient2025_04_04
"mcp-client-2025-11-20"McpClient2025_11_20
"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14
"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14
"code-execution-2025-05-22"CodeExecution2025_05_22
"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11
"context-1m-2025-08-07"Context1m2025_08_07
"context-management-2025-06-27"ContextManagement2025_06_27
"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26
"skills-2025-10-02"Skills2025_10_02
"fast-mode-2026-02-01"FastMode2026_02_01
##### ReturnsExpand Collapse
class ModelListPageResponse:
required IReadOnlyList\<[BetaModelInfo](/docs/en/api/beta#beta_model_info)\> Data
required string ID
Unique model identifier.
required [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)? Capabilities
Model capability information.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) ContextManagement
Context management support and available strategies.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) Types
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
required string? FirstID
First ID in the `data` list. Can be used as the `before_id` for the previous page.
required Boolean HasMore
Indicates if there are more results in the requested page direction.
required string? LastID
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
C#
```python
ModelListParams parameters = new();
var page = await client.Beta.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-csharp-beta-models-retrieve-cee06c3353.md
## Retrieve
`BetaModelInfo Beta.Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams parameters`
- `required string modelID`
Model identifier or alias.
- `IReadOnlyList betas`
Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class BetaModelInfo:`
- `required string ID`
Unique model identifier.
- `required BetaModelCapabilities? Capabilities`
Model capability information.
- `required BetaCapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required BetaCapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaEffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required BetaCapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaThinkingTypes Types`
Supported thinking type configurations.
- `required BetaCapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required BetaCapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Example
```csharp
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var betaModelInfo = await client.Beta.Models.Retrieve(parameters);
Console.WriteLine(betaModelInfo);
```
---
## api-csharp-beta-models-retrieve.md
# Get a Model
[BetaModelInfo](/docs/en/api/beta#beta_model_info) Beta.Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
ModelRetrieveParams parameters
required string modelID
Model identifier or alias.
IReadOnlyList\<[AnthropicBeta](/docs/en/api/beta#anthropic_beta)\> betas
Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"MessageBatches2024_09_24
"prompt-caching-2024-07-31"PromptCaching2024_07_31
"computer-use-2024-10-22"ComputerUse2024_10_22
"computer-use-2025-01-24"ComputerUse2025_01_24
"pdfs-2024-09-25"Pdfs2024_09_25
"token-counting-2024-11-01"TokenCounting2024_11_01
"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19
"output-128k-2025-02-19"Output128k2025_02_19
"files-api-2025-04-14"FilesApi2025_04_14
"mcp-client-2025-04-04"McpClient2025_04_04
"mcp-client-2025-11-20"McpClient2025_11_20
"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14
"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14
"code-execution-2025-05-22"CodeExecution2025_05_22
"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11
"context-1m-2025-08-07"Context1m2025_08_07
"context-management-2025-06-27"ContextManagement2025_06_27
"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26
"skills-2025-10-02"Skills2025_10_02
"fast-mode-2026-02-01"FastMode2026_02_01
##### ReturnsExpand Collapse
class BetaModelInfo:
required string ID
Unique model identifier.
required [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)? Capabilities
Model capability information.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) ContextManagement
Context management support and available strategies.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) Types
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
Get a Model
C#
```python
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var betaModelInfo = await client.Beta.Models.Retrieve(parameters);
Console.WriteLine(betaModelInfo);
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-csharp-beta-models.md
# Models
##### [List Models](/docs/en/api/beta/models/list)
[ModelListPageResponse](/docs/en/api/beta#ModelListPageResponse) Beta.Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)
GET/v1/models
##### [Get a Model](/docs/en/api/beta/models/retrieve)
[BetaModelInfo](/docs/en/api/beta#beta_model_info) Beta.Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
class BetaCapabilitySupport:
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
class BetaContextManagementCapability:
Context management capability details.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
class BetaEffortCapability:
Effort (reasoning_effort) capability details.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
class BetaModelCapabilities:
Model capability information.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) ContextManagement
Context management support and available strategies.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) Types
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
class BetaModelInfo:
required string ID
Unique model identifier.
required [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)? Capabilities
Model capability information.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) ContextManagement
Context management support and available strategies.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) Types
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
class BetaThinkingCapability:
Thinking capability details.
required Boolean Supported
Whether this capability is supported by the model.
required [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) Types
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
class BetaThinkingTypes:
Supported thinking type configurations.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
---
## api-csharp-models-b1bf3133da.md
# Models
## List
`ModelListPageResponse Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams parameters`
- `string afterID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `string beforeID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Long limit`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `IReadOnlyList betas`
Header param: Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelListPageResponse:`
- `required IReadOnlyList Data`
- `required string ID`
Unique model identifier.
- `required ModelCapabilities? Capabilities`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
- `required string? FirstID`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `required Boolean HasMore`
Indicates if there are more results in the requested page direction.
- `required string? LastID`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```csharp
ModelListParams parameters = new();
var page = await client.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
## Retrieve
`ModelInfo Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams parameters`
- `required string modelID`
Model identifier or alias.
- `IReadOnlyList betas`
Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelInfo:`
- `required string ID`
Unique model identifier.
- `required ModelCapabilities? Capabilities`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Example
```csharp
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var modelInfo = await client.Models.Retrieve(parameters);
Console.WriteLine(modelInfo);
```
## Domain Types
### Capability Support
- `class CapabilitySupport:`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Context Management Capability
- `class ContextManagementCapability:`
Context management capability details.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Effort Capability
- `class EffortCapability:`
Effort (reasoning_effort) capability details.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Model Capabilities
- `class ModelCapabilities:`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Model Info
- `class ModelInfo:`
- `required string ID`
Unique model identifier.
- `required ModelCapabilities? Capabilities`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Thinking Capability
- `class ThinkingCapability:`
Thinking capability details.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
### Thinking Types
- `class ThinkingTypes:`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
---
## api-csharp-models-list-b002a3b259.md
## List
`ModelListPageResponse Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams parameters`
- `string afterID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `string beforeID`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Long limit`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `IReadOnlyList betas`
Header param: Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelListPageResponse:`
- `required IReadOnlyList Data`
- `required string ID`
Unique model identifier.
- `required ModelCapabilities? Capabilities`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
- `required string? FirstID`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `required Boolean HasMore`
Indicates if there are more results in the requested page direction.
- `required string? LastID`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```csharp
ModelListParams parameters = new();
var page = await client.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
---
## api-csharp-models-list.md
# List Models
[ModelListPageResponse](/docs/en/api/models#ModelListPageResponse) Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
ModelListParams parameters
string afterID
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
string beforeID
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Long limit
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
IReadOnlyList\<[AnthropicBeta](/docs/en/api/beta#anthropic_beta)\> betas
Header param: Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"MessageBatches2024_09_24
"prompt-caching-2024-07-31"PromptCaching2024_07_31
"computer-use-2024-10-22"ComputerUse2024_10_22
"computer-use-2025-01-24"ComputerUse2025_01_24
"pdfs-2024-09-25"Pdfs2024_09_25
"token-counting-2024-11-01"TokenCounting2024_11_01
"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19
"output-128k-2025-02-19"Output128k2025_02_19
"files-api-2025-04-14"FilesApi2025_04_14
"mcp-client-2025-04-04"McpClient2025_04_04
"mcp-client-2025-11-20"McpClient2025_11_20
"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14
"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14
"code-execution-2025-05-22"CodeExecution2025_05_22
"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11
"context-1m-2025-08-07"Context1m2025_08_07
"context-management-2025-06-27"ContextManagement2025_06_27
"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26
"skills-2025-10-02"Skills2025_10_02
"fast-mode-2026-02-01"FastMode2026_02_01
##### ReturnsExpand Collapse
class ModelListPageResponse:
required IReadOnlyList\<[ModelInfo](/docs/en/api/models#model_info)\> Data
required string ID
Unique model identifier.
required [ModelCapabilities](/docs/en/api/models#model_capabilities)? Capabilities
Model capability information.
required [CapabilitySupport](/docs/en/api/models#capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [ContextManagementCapability](/docs/en/api/models#context_management_capability) ContextManagement
Context management support and available strategies.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [EffortCapability](/docs/en/api/models#effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [CapabilitySupport](/docs/en/api/models#capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingCapability](/docs/en/api/models#thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingTypes](/docs/en/api/models#thinking_types) Types
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
required string? FirstID
First ID in the `data` list. Can be used as the `before_id` for the previous page.
required Boolean HasMore
Indicates if there are more results in the requested page direction.
required string? LastID
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
C#
```python
ModelListParams parameters = new();
var page = await client.Models.List(parameters);
await foreach (var item in page.Paginate())
{
Console.WriteLine(item);
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-csharp-models-retrieve-18bdbda1bf.md
## Retrieve
`ModelInfo Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams parameters`
- `required string modelID`
Model identifier or alias.
- `IReadOnlyList betas`
Optional header to specify the beta version(s) you want to use.
- `"message-batches-2024-09-24"MessageBatches2024_09_24`
- `"prompt-caching-2024-07-31"PromptCaching2024_07_31`
- `"computer-use-2024-10-22"ComputerUse2024_10_22`
- `"computer-use-2025-01-24"ComputerUse2025_01_24`
- `"pdfs-2024-09-25"Pdfs2024_09_25`
- `"token-counting-2024-11-01"TokenCounting2024_11_01`
- `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19`
- `"output-128k-2025-02-19"Output128k2025_02_19`
- `"files-api-2025-04-14"FilesApi2025_04_14`
- `"mcp-client-2025-04-04"McpClient2025_04_04`
- `"mcp-client-2025-11-20"McpClient2025_11_20`
- `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14`
- `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14`
- `"code-execution-2025-05-22"CodeExecution2025_05_22`
- `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11`
- `"context-1m-2025-08-07"Context1m2025_08_07`
- `"context-management-2025-06-27"ContextManagement2025_06_27`
- `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26`
- `"skills-2025-10-02"Skills2025_10_02`
- `"fast-mode-2026-02-01"FastMode2026_02_01`
- `"output-300k-2026-03-24"Output300k2026_03_24`
- `"advisor-tool-2026-03-01"AdvisorTool2026_03_01`
### Returns
- `class ModelInfo:`
- `required string ID`
Unique model identifier.
- `required ModelCapabilities? Capabilities`
Model capability information.
- `required CapabilitySupport Batch`
Whether the model supports the Batch API.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Citations`
Whether the model supports citation generation.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport CodeExecution`
Whether the model supports code execution tools.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ContextManagementCapability ContextManagement`
Context management support and available strategies.
- `required CapabilitySupport? ClearThinking20251015`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? ClearToolUses20250919`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport? Compact20260112`
Indicates whether a capability is supported.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required EffortCapability Effort`
Effort (reasoning_effort) support and available levels.
- `required CapabilitySupport High`
Whether the model supports high effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Low`
Whether the model supports low effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Max`
Whether the model supports max effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Medium`
Whether the model supports medium effort level.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport ImageInput`
Whether the model accepts image content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport PdfInput`
Whether the model accepts PDF content blocks.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport StructuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingCapability Thinking`
Thinking capability and supported type configurations.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required ThinkingTypes Types`
Supported thinking type configurations.
- `required CapabilitySupport Adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required CapabilitySupport Enabled`
Whether the model supports thinking with type 'enabled'.
- `required Boolean Supported`
Whether this capability is supported by the model.
- `required DateTimeOffset CreatedAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `required string DisplayName`
A human-readable name for the model.
- `required Long? MaxInputTokens`
Maximum input context window size in tokens for this model.
- `required Long? MaxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonElement Type "model"constant`
Object type.
For Models, this is always `"model"`.
### Example
```csharp
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var modelInfo = await client.Models.Retrieve(parameters);
Console.WriteLine(modelInfo);
```
---
## api-csharp-models-retrieve.md
# Get a Model
[ModelInfo](/docs/en/api/models#model_info) Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
ModelRetrieveParams parameters
required string modelID
Model identifier or alias.
IReadOnlyList\<[AnthropicBeta](/docs/en/api/beta#anthropic_beta)\> betas
Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"MessageBatches2024_09_24
"prompt-caching-2024-07-31"PromptCaching2024_07_31
"computer-use-2024-10-22"ComputerUse2024_10_22
"computer-use-2025-01-24"ComputerUse2025_01_24
"pdfs-2024-09-25"Pdfs2024_09_25
"token-counting-2024-11-01"TokenCounting2024_11_01
"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19
"output-128k-2025-02-19"Output128k2025_02_19
"files-api-2025-04-14"FilesApi2025_04_14
"mcp-client-2025-04-04"McpClient2025_04_04
"mcp-client-2025-11-20"McpClient2025_11_20
"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14
"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14
"code-execution-2025-05-22"CodeExecution2025_05_22
"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11
"context-1m-2025-08-07"Context1m2025_08_07
"context-management-2025-06-27"ContextManagement2025_06_27
"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26
"skills-2025-10-02"Skills2025_10_02
"fast-mode-2026-02-01"FastMode2026_02_01
##### ReturnsExpand Collapse
class ModelInfo:
required string ID
Unique model identifier.
required [ModelCapabilities](/docs/en/api/models#model_capabilities)? Capabilities
Model capability information.
required [CapabilitySupport](/docs/en/api/models#capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [ContextManagementCapability](/docs/en/api/models#context_management_capability) ContextManagement
Context management support and available strategies.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [EffortCapability](/docs/en/api/models#effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [CapabilitySupport](/docs/en/api/models#capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingCapability](/docs/en/api/models#thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingTypes](/docs/en/api/models#thinking_types) Types
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
Get a Model
C#
```python
ModelRetrieveParams parameters = new() { ModelID = "model_id" };
var modelInfo = await client.Models.Retrieve(parameters);
Console.WriteLine(modelInfo);
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-csharp-models.md
# Models
##### [List Models](/docs/en/api/models/list)
[ModelListPageResponse](/docs/en/api/models#ModelListPageResponse) Models.List(ModelListParams?parameters, CancellationTokencancellationToken = default)
GET/v1/models
##### [Get a Model](/docs/en/api/models/retrieve)
[ModelInfo](/docs/en/api/models#model_info) Models.Retrieve(ModelRetrieveParamsparameters, CancellationTokencancellationToken = default)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
class CapabilitySupport:
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
class ContextManagementCapability:
Context management capability details.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
class EffortCapability:
Effort (reasoning_effort) capability details.
required [CapabilitySupport](/docs/en/api/models#capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
class ModelCapabilities:
Model capability information.
required [CapabilitySupport](/docs/en/api/models#capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [ContextManagementCapability](/docs/en/api/models#context_management_capability) ContextManagement
Context management support and available strategies.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [EffortCapability](/docs/en/api/models#effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [CapabilitySupport](/docs/en/api/models#capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingCapability](/docs/en/api/models#thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingTypes](/docs/en/api/models#thinking_types) Types
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
class ModelInfo:
required string ID
Unique model identifier.
required [ModelCapabilities](/docs/en/api/models#model_capabilities)? Capabilities
Model capability information.
required [CapabilitySupport](/docs/en/api/models#capability_support) Batch
Whether the model supports the Batch API.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Citations
Whether the model supports citation generation.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) CodeExecution
Whether the model supports code execution tools.
required Boolean Supported
Whether this capability is supported by the model.
required [ContextManagementCapability](/docs/en/api/models#context_management_capability) ContextManagement
Context management support and available strategies.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearThinking20251015
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? ClearToolUses20250919
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support)? Compact20260112
Indicates whether a capability is supported.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [EffortCapability](/docs/en/api/models#effort_capability) Effort
Effort (reasoning_effort) support and available levels.
required [CapabilitySupport](/docs/en/api/models#capability_support) High
Whether the model supports high effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Low
Whether the model supports low effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Max
Whether the model supports max effort level.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Medium
Whether the model supports medium effort level.
required Boolean Supported
Whether this capability is supported by the model.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) ImageInput
Whether the model accepts image content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) PdfInput
Whether the model accepts PDF content blocks.
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) StructuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingCapability](/docs/en/api/models#thinking_capability) Thinking
Thinking capability and supported type configurations.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingTypes](/docs/en/api/models#thinking_types) Types
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
required DateTimeOffset CreatedAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
required string DisplayName
A human-readable name for the model.
required Long? MaxInputTokens
Maximum input context window size in tokens for this model.
required Long? MaxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonElement Type "model"constant
Object type.
For Models, this is always `"model"`.
class ThinkingCapability:
Thinking capability details.
required Boolean Supported
Whether this capability is supported by the model.
required [ThinkingTypes](/docs/en/api/models#thinking_types) Types
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
class ThinkingTypes:
Supported thinking type configurations.
required [CapabilitySupport](/docs/en/api/models#capability_support) Adaptive
Whether the model supports thinking with type 'adaptive' (auto).
required Boolean Supported
Whether this capability is supported by the model.
required [CapabilitySupport](/docs/en/api/models#capability_support) Enabled
Whether the model supports thinking with type 'enabled'.
required Boolean Supported
Whether this capability is supported by the model.
---
## api-go-beta-models-dc67d6d98f.md
# Models
## List
`client.Beta.Models.List(ctx, params) (*Page[BetaModelInfo], error)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `params BetaModelListParams`
- `AfterID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `BeforeID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Limit param.Field[int64]`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Betas param.Field[[]AnthropicBeta]`
Header param: Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type BetaModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities BetaModelCapabilities`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Beta.Models.List(context.TODO(), anthropic.BetaModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
## Retrieve
`client.Beta.Models.Get(ctx, modelID, query) (*BetaModelInfo, error)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `modelID string`
Model identifier or alias.
- `query BetaModelGetParams`
- `Betas param.Field[[]AnthropicBeta]`
Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type BetaModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities BetaModelCapabilities`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
betaModelInfo, err := client.Beta.Models.Get(
context.TODO(),
"model_id",
anthropic.BetaModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", betaModelInfo.ID)
}
```
## Domain Types
### Beta Capability Support
- `type BetaCapabilitySupport struct{…}`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
### Beta Context Management Capability
- `type BetaContextManagementCapability struct{…}`
Context management capability details.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
### Beta Effort Capability
- `type BetaEffortCapability struct{…}`
Effort (reasoning_effort) capability details.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
### Beta Model Capabilities
- `type BetaModelCapabilities struct{…}`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
### Beta Model Info
- `type BetaModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities BetaModelCapabilities`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Beta Thinking Capability
- `type BetaThinkingCapability struct{…}`
Thinking capability details.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
### Beta Thinking Types
- `type BetaThinkingTypes struct{…}`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
---
## api-go-beta-models-list-8508160c0c.md
## List
`client.Beta.Models.List(ctx, params) (*Page[BetaModelInfo], error)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `params BetaModelListParams`
- `AfterID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `BeforeID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Limit param.Field[int64]`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Betas param.Field[[]AnthropicBeta]`
Header param: Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type BetaModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities BetaModelCapabilities`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Beta.Models.List(context.TODO(), anthropic.BetaModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
---
## api-go-beta-models-list.md
# List Models
client.Beta.Models.List(ctx, params) (\*Page\[[BetaModelInfo](/docs/en/api/beta#beta_model_info)\], error)
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
params BetaModelListParams
AfterID param.Field\[string\]
optional
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
BeforeID param.Field\[string\]
optional
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Limit param.Field\[int64\]
optional
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
Betas param.Field\[\[\]AnthropicBeta\]
optional
Header param: Optional header to specify the beta version(s) you want to use.
string
type AnthropicBeta string
Accepts one of the following:
const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"
const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"
const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"
const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"
const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"
const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"
const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"
const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"
const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"
const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"
const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"
const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"
const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"
const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"
const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"
const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"
const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"
const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"
const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"
const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"
##### ReturnsExpand Collapse
type BetaModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)
Model capability information.
Batch [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability)
Effort (reasoning_effort) support and available levels.
High [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types)
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
List Models
Go
```python
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Beta.Models.List(context.TODO(), anthropic.BetaModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-go-beta-models-retrieve-2c08672762.md
## Retrieve
`client.Beta.Models.Get(ctx, modelID, query) (*BetaModelInfo, error)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `modelID string`
Model identifier or alias.
- `query BetaModelGetParams`
- `Betas param.Field[[]AnthropicBeta]`
Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type BetaModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities BetaModelCapabilities`
Model capability information.
- `Batch BetaCapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations BetaCapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution BetaCapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement BetaContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 BetaCapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort BetaEffortCapability`
Effort (reasoning_effort) support and available levels.
- `High BetaCapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low BetaCapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max BetaCapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium BetaCapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput BetaCapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput BetaCapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs BetaCapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking BetaThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types BetaThinkingTypes`
Supported thinking type configurations.
- `Adaptive BetaCapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled BetaCapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
betaModelInfo, err := client.Beta.Models.Get(
context.TODO(),
"model_id",
anthropic.BetaModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", betaModelInfo.ID)
}
```
---
## api-go-beta-models-retrieve.md
# Get a Model
client.Beta.Models.Get(ctx, modelID, query) (\*[BetaModelInfo](/docs/en/api/beta#beta_model_info), error)
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
modelID string
Model identifier or alias.
query BetaModelGetParams
Betas param.Field\[\[\]AnthropicBeta\]
optional
Optional header to specify the beta version(s) you want to use.
string
type AnthropicBeta string
Accepts one of the following:
const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"
const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"
const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"
const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"
const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"
const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"
const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"
const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"
const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"
const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"
const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"
const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"
const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"
const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"
const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"
const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"
const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"
const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"
const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"
const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"
##### ReturnsExpand Collapse
type BetaModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)
Model capability information.
Batch [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability)
Effort (reasoning_effort) support and available levels.
High [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types)
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
Get a Model
Go
```python
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
betaModelInfo, err := client.Beta.Models.Get(
context.TODO(),
"model_id",
anthropic.BetaModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", betaModelInfo.ID)
}
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-go-beta-models.md
# Models
##### [List Models](/docs/en/api/beta/models/list)
client.Beta.Models.List(ctx, params) (\*Page\[[BetaModelInfo](/docs/en/api/beta#beta_model_info)\], error)
GET/v1/models
##### [Get a Model](/docs/en/api/beta/models/retrieve)
client.Beta.Models.Get(ctx, modelID, query) (\*[BetaModelInfo](/docs/en/api/beta#beta_model_info), error)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
type BetaCapabilitySupport struct{…}
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
type BetaContextManagementCapability struct{…}
Context management capability details.
ClearThinking20251015 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
type BetaEffortCapability struct{…}
Effort (reasoning_effort) capability details.
High [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
type BetaModelCapabilities struct{…}
Model capability information.
Batch [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability)
Effort (reasoning_effort) support and available levels.
High [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types)
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
type BetaModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)
Model capability information.
Batch [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [BetaEffortCapability](/docs/en/api/beta#beta_effort_capability)
Effort (reasoning_effort) support and available levels.
High [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types)
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
type BetaThinkingCapability struct{…}
Thinking capability details.
Supported bool
Whether this capability is supported by the model.
Types [BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types)
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
type BetaThinkingTypes struct{…}
Supported thinking type configurations.
Adaptive [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
---
## api-go-models-25db9e22b0.md
# Models
## List
`client.Models.List(ctx, params) (*Page[ModelInfo], error)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `params ModelListParams`
- `AfterID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `BeforeID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Limit param.Field[int64]`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Betas param.Field[[]AnthropicBeta]`
Header param: Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type ModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities ModelCapabilities`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Models.List(context.TODO(), anthropic.ModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
## Retrieve
`client.Models.Get(ctx, modelID, query) (*ModelInfo, error)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `modelID string`
Model identifier or alias.
- `query ModelGetParams`
- `Betas param.Field[[]AnthropicBeta]`
Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type ModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities ModelCapabilities`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
modelInfo, err := client.Models.Get(
context.TODO(),
"model_id",
anthropic.ModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", modelInfo.ID)
}
```
## Domain Types
### Capability Support
- `type CapabilitySupport struct{…}`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
### Context Management Capability
- `type ContextManagementCapability struct{…}`
Context management capability details.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
### Effort Capability
- `type EffortCapability struct{…}`
Effort (reasoning_effort) capability details.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
### Model Capabilities
- `type ModelCapabilities struct{…}`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
### Model Info
- `type ModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities ModelCapabilities`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Thinking Capability
- `type ThinkingCapability struct{…}`
Thinking capability details.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
### Thinking Types
- `type ThinkingTypes struct{…}`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
---
## api-go-models-list-b97b073d73.md
## List
`client.Models.List(ctx, params) (*Page[ModelInfo], error)`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `params ModelListParams`
- `AfterID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `BeforeID param.Field[string]`
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Limit param.Field[int64]`
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Betas param.Field[[]AnthropicBeta]`
Header param: Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type ModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities ModelCapabilities`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Models.List(context.TODO(), anthropic.ModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
---
## api-go-models-list.md
# List Models
client.Models.List(ctx, params) (\*Page\[[ModelInfo](/docs/en/api/models#model_info)\], error)
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
params ModelListParams
AfterID param.Field\[string\]
optional
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
BeforeID param.Field\[string\]
optional
Query param: ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Limit param.Field\[int64\]
optional
Query param: Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
Betas param.Field\[\[\]AnthropicBeta\]
optional
Header param: Optional header to specify the beta version(s) you want to use.
string
type AnthropicBeta string
Accepts one of the following:
const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"
const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"
const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"
const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"
const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"
const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"
const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"
const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"
const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"
const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"
const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"
const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"
const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"
const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"
const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"
const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"
const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"
const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"
const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"
const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"
##### ReturnsExpand Collapse
type ModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [ModelCapabilities](/docs/en/api/models#model_capabilities)
Model capability information.
Batch [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [ContextManagementCapability](/docs/en/api/models#context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [EffortCapability](/docs/en/api/models#effort_capability)
Effort (reasoning_effort) support and available levels.
High [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [ThinkingCapability](/docs/en/api/models#thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [ThinkingTypes](/docs/en/api/models#thinking_types)
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
List Models
Go
```python
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
page, err := client.Models.List(context.TODO(), anthropic.ModelListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", page)
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-go-models-retrieve-313338efb3.md
## Retrieve
`client.Models.Get(ctx, modelID, query) (*ModelInfo, error)`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `modelID string`
Model identifier or alias.
- `query ModelGetParams`
- `Betas param.Field[[]AnthropicBeta]`
Optional header to specify the beta version(s) you want to use.
- `string`
- `type AnthropicBeta string`
- `const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"`
- `const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"`
- `const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"`
- `const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"`
- `const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"`
- `const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"`
- `const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"`
- `const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"`
- `const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"`
- `const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"`
- `const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"`
- `const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"`
- `const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"`
- `const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"`
- `const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"`
- `const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"`
- `const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"`
- `const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"`
- `const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"`
- `const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"`
- `const AnthropicBetaOutput300k2026_03_24 AnthropicBeta = "output-300k-2026-03-24"`
- `const AnthropicBetaAdvisorTool2026_03_01 AnthropicBeta = "advisor-tool-2026-03-01"`
### Returns
- `type ModelInfo struct{…}`
- `ID string`
Unique model identifier.
- `Capabilities ModelCapabilities`
Model capability information.
- `Batch CapabilitySupport`
Whether the model supports the Batch API.
- `Supported bool`
Whether this capability is supported by the model.
- `Citations CapabilitySupport`
Whether the model supports citation generation.
- `Supported bool`
Whether this capability is supported by the model.
- `CodeExecution CapabilitySupport`
Whether the model supports code execution tools.
- `Supported bool`
Whether this capability is supported by the model.
- `ContextManagement ContextManagementCapability`
Context management support and available strategies.
- `ClearThinking20251015 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `ClearToolUses20250919 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Compact20260112 CapabilitySupport`
Indicates whether a capability is supported.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `Effort EffortCapability`
Effort (reasoning_effort) support and available levels.
- `High CapabilitySupport`
Whether the model supports high effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Low CapabilitySupport`
Whether the model supports low effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Max CapabilitySupport`
Whether the model supports max effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Medium CapabilitySupport`
Whether the model supports medium effort level.
- `Supported bool`
Whether this capability is supported by the model.
- `Supported bool`
Whether this capability is supported by the model.
- `ImageInput CapabilitySupport`
Whether the model accepts image content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `PDFInput CapabilitySupport`
Whether the model accepts PDF content blocks.
- `Supported bool`
Whether this capability is supported by the model.
- `StructuredOutputs CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `Supported bool`
Whether this capability is supported by the model.
- `Thinking ThinkingCapability`
Thinking capability and supported type configurations.
- `Supported bool`
Whether this capability is supported by the model.
- `Types ThinkingTypes`
Supported thinking type configurations.
- `Adaptive CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `Supported bool`
Whether this capability is supported by the model.
- `Enabled CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `Supported bool`
Whether this capability is supported by the model.
- `CreatedAt Time`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `DisplayName string`
A human-readable name for the model.
- `MaxInputTokens int64`
Maximum input context window size in tokens for this model.
- `MaxTokens int64`
Maximum value for the `max_tokens` parameter when using this model.
- `Type Model`
Object type.
For Models, this is always `"model"`.
- `const ModelModel Model = "model"`
### Example
```go
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
modelInfo, err := client.Models.Get(
context.TODO(),
"model_id",
anthropic.ModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", modelInfo.ID)
}
```
---
## api-go-models-retrieve.md
# Get a Model
client.Models.Get(ctx, modelID, query) (\*[ModelInfo](/docs/en/api/models#model_info), error)
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
modelID string
Model identifier or alias.
query ModelGetParams
Betas param.Field\[\[\]AnthropicBeta\]
optional
Optional header to specify the beta version(s) you want to use.
string
type AnthropicBeta string
Accepts one of the following:
const AnthropicBetaMessageBatches2024_09_24 AnthropicBeta = "message-batches-2024-09-24"
const AnthropicBetaPromptCaching2024_07_31 AnthropicBeta = "prompt-caching-2024-07-31"
const AnthropicBetaComputerUse2024_10_22 AnthropicBeta = "computer-use-2024-10-22"
const AnthropicBetaComputerUse2025_01_24 AnthropicBeta = "computer-use-2025-01-24"
const AnthropicBetaPDFs2024_09_25 AnthropicBeta = "pdfs-2024-09-25"
const AnthropicBetaTokenCounting2024_11_01 AnthropicBeta = "token-counting-2024-11-01"
const AnthropicBetaTokenEfficientTools2025_02_19 AnthropicBeta = "token-efficient-tools-2025-02-19"
const AnthropicBetaOutput128k2025_02_19 AnthropicBeta = "output-128k-2025-02-19"
const AnthropicBetaFilesAPI2025_04_14 AnthropicBeta = "files-api-2025-04-14"
const AnthropicBetaMCPClient2025_04_04 AnthropicBeta = "mcp-client-2025-04-04"
const AnthropicBetaMCPClient2025_11_20 AnthropicBeta = "mcp-client-2025-11-20"
const AnthropicBetaDevFullThinking2025_05_14 AnthropicBeta = "dev-full-thinking-2025-05-14"
const AnthropicBetaInterleavedThinking2025_05_14 AnthropicBeta = "interleaved-thinking-2025-05-14"
const AnthropicBetaCodeExecution2025_05_22 AnthropicBeta = "code-execution-2025-05-22"
const AnthropicBetaExtendedCacheTTL2025_04_11 AnthropicBeta = "extended-cache-ttl-2025-04-11"
const AnthropicBetaContext1m2025_08_07 AnthropicBeta = "context-1m-2025-08-07"
const AnthropicBetaContextManagement2025_06_27 AnthropicBeta = "context-management-2025-06-27"
const AnthropicBetaModelContextWindowExceeded2025_08_26 AnthropicBeta = "model-context-window-exceeded-2025-08-26"
const AnthropicBetaSkills2025_10_02 AnthropicBeta = "skills-2025-10-02"
const AnthropicBetaFastMode2026_02_01 AnthropicBeta = "fast-mode-2026-02-01"
##### ReturnsExpand Collapse
type ModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [ModelCapabilities](/docs/en/api/models#model_capabilities)
Model capability information.
Batch [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [ContextManagementCapability](/docs/en/api/models#context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [EffortCapability](/docs/en/api/models#effort_capability)
Effort (reasoning_effort) support and available levels.
High [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [ThinkingCapability](/docs/en/api/models#thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [ThinkingTypes](/docs/en/api/models#thinking_types)
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
Get a Model
Go
```python
package main
import (
"context"
"fmt"
"github.com/anthropics/anthropic-sdk-go"
"github.com/anthropics/anthropic-sdk-go/option"
)
func main() {
client := anthropic.NewClient(
option.WithAPIKey("my-anthropic-api-key"),
)
modelInfo, err := client.Models.Get(
context.TODO(),
"model_id",
anthropic.ModelGetParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", modelInfo.ID)
}
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-go-models.md
# Models
##### [List Models](/docs/en/api/models/list)
client.Models.List(ctx, params) (\*Page\[[ModelInfo](/docs/en/api/models#model_info)\], error)
GET/v1/models
##### [Get a Model](/docs/en/api/models/retrieve)
client.Models.Get(ctx, modelID, query) (\*[ModelInfo](/docs/en/api/models#model_info), error)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
type CapabilitySupport struct{…}
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
type ContextManagementCapability struct{…}
Context management capability details.
ClearThinking20251015 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
type EffortCapability struct{…}
Effort (reasoning_effort) capability details.
High [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
type ModelCapabilities struct{…}
Model capability information.
Batch [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [ContextManagementCapability](/docs/en/api/models#context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [EffortCapability](/docs/en/api/models#effort_capability)
Effort (reasoning_effort) support and available levels.
High [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [ThinkingCapability](/docs/en/api/models#thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [ThinkingTypes](/docs/en/api/models#thinking_types)
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
type ModelInfo struct{…}
ID string
Unique model identifier.
Capabilities [ModelCapabilities](/docs/en/api/models#model_capabilities)
Model capability information.
Batch [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports the Batch API.
Supported bool
Whether this capability is supported by the model.
Citations [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports citation generation.
Supported bool
Whether this capability is supported by the model.
CodeExecution [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports code execution tools.
Supported bool
Whether this capability is supported by the model.
ContextManagement [ContextManagementCapability](/docs/en/api/models#context_management_capability)
Context management support and available strategies.
ClearThinking20251015 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
ClearToolUses20250919 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Compact20260112 [CapabilitySupport](/docs/en/api/models#capability_support)
Indicates whether a capability is supported.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
Effort [EffortCapability](/docs/en/api/models#effort_capability)
Effort (reasoning_effort) support and available levels.
High [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports high effort level.
Supported bool
Whether this capability is supported by the model.
Low [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports low effort level.
Supported bool
Whether this capability is supported by the model.
Max [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports max effort level.
Supported bool
Whether this capability is supported by the model.
Medium [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports medium effort level.
Supported bool
Whether this capability is supported by the model.
Supported bool
Whether this capability is supported by the model.
ImageInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts image content blocks.
Supported bool
Whether this capability is supported by the model.
PDFInput [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model accepts PDF content blocks.
Supported bool
Whether this capability is supported by the model.
StructuredOutputs [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports structured output / JSON mode / strict tool schemas.
Supported bool
Whether this capability is supported by the model.
Thinking [ThinkingCapability](/docs/en/api/models#thinking_capability)
Thinking capability and supported type configurations.
Supported bool
Whether this capability is supported by the model.
Types [ThinkingTypes](/docs/en/api/models#thinking_types)
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
CreatedAt Time
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
DisplayName string
A human-readable name for the model.
MaxInputTokens int64
Maximum input context window size in tokens for this model.
MaxTokens int64
Maximum value for the `max_tokens` parameter when using this model.
Type Model
Object type.
For Models, this is always `"model"`.
type ThinkingCapability struct{…}
Thinking capability details.
Supported bool
Whether this capability is supported by the model.
Types [ThinkingTypes](/docs/en/api/models#thinking_types)
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
type ThinkingTypes struct{…}
Supported thinking type configurations.
Adaptive [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'adaptive' (auto).
Supported bool
Whether this capability is supported by the model.
Enabled [CapabilitySupport](/docs/en/api/models#capability_support)
Whether the model supports thinking with type 'enabled'.
Supported bool
Whether this capability is supported by the model.
---
## api-http-beta-models-634c8759da.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fhttp%2Fbeta%2Fmodels)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
# Models
##### [List Models](/docs/en/api/http/beta/models/list)
GET/v1/models
List available models.
##### [Get a Model](/docs/en/api/http/beta/models/retrieve)
GET/v1/models/{model_id}
Get a specific model.
##### Models
BetaCapabilitySupport object{ supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
BetaCompactionCapability object{ summarize, supported }
Compaction capability details: whether the model accepts the top-level `compaction` request parameter, with one entry per supported `compaction.type` value.
summarize: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the summarize compaction type is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaContextManagementCapability object{ clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management capability details.
clear_thinking_20251015: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the clear_thinking_20251015 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the clear_tool_uses_20250919 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported } or null
Whether the compact_20260112 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
BetaEffortCapability object{ high, low, max, 3 more }
Effort (reasoning_effort) capability details.
BetaModelCapabilities object{ batch, citations, code_execution, 7 more }
Model capability information.
BetaModelInfo object{ type: "model", id, allowed_fallback_models, 5 more }
BetaThinkingCapability object{ supported, types }
Thinking capability details.
supported: boolean
Whether this capability is supported by the model.
types: [BetaThinkingTypes](/docs/en/api/http/beta/models#beta_thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
BetaThinkingTypes object{ adaptive, enabled }
Supported thinking type configurations.
adaptive: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [BetaCapabilitySupport](/docs/en/api/http/beta/models#beta_capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
---
## api-http-beta-models-list-388647d0ba.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fhttp%2Fbeta%2Fmodels%2Flist)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
3. [Models](/docs/en/api/http/beta/models)
# List Models
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### Query parameters
after_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
before_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
default20
minimum1
maximum1000
##### Headers
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
##### Returns
data: array of [BetaModelInfo](/docs/en/api/http/beta/models#beta_model_info) { type: "model", id, allowed_fallback_models, 5 more }
type: "model"
Object type.
For Models, this is always `"model"`.
defaultmodel
id: string
Unique model identifier.
allowed_fallback_models: array of string or null
Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An empty list means the `fallbacks` parameter is not supported for this model as primary.
capabilities: [BetaModelCapabilities](/docs/en/api/http/beta/models#beta_model_capabilities) { batch, citations, code_execution, 7 more } or null
Object mapping capability names to their support details. Keys are always present for all known capabilities.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
formatdate-time
display_name: string
A human-readable name for the model.
max_input_tokens: number or null
Maximum input context window size in tokens for this model.
max_tokens: number or null
Maximum value for the `max_tokens` parameter when using this model.
first_id: string or null
First ID in the `data` list. Can be used as the `before_id` for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string or null
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
cURL
```python
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-http-beta-models-retrieve-637442e047.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fhttp%2Fbeta%2Fmodels%2Fretrieve)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
1. [API reference](/docs/en/api/http)
2. [Beta](/docs/en/api/http/beta)
3. [Models](/docs/en/api/http/beta/models)
# Get a Model
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### Path parameters
model_id: string
Model identifier or alias.
##### Headers
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
##### Returns
BetaModelInfo object{ type: "model", id, allowed_fallback_models, 5 more }
Get a Model
cURL
```python
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-5",
"allowed_fallback_models": [
"string"
],
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"compaction": {
"summarize": {
"supported": true
},
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-java-beta-models-64a1025640.md
# Models
## List
`ModelListPage beta().models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams params`
- `Optional afterId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `Optional beforeId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Optional limit`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class BetaModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.ModelListPage;
import com.anthropic.models.beta.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.beta().models().list();
}
}
```
## Retrieve
`BetaModelInfo beta().models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams params`
- `Optional modelId`
Model identifier or alias.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class BetaModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.BetaModelInfo;
import com.anthropic.models.beta.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
BetaModelInfo betaModelInfo = client.beta().models().retrieve("model_id");
}
}
```
## Domain Types
### Beta Capability Support
- `class BetaCapabilitySupport:`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
### Beta Context Management Capability
- `class BetaContextManagementCapability:`
Context management capability details.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
### Beta Effort Capability
- `class BetaEffortCapability:`
Effort (reasoning_effort) capability details.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
### Beta Model Capabilities
- `class BetaModelCapabilities:`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
### Beta Model Info
- `class BetaModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Beta Thinking Capability
- `class BetaThinkingCapability:`
Thinking capability details.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
### Beta Thinking Types
- `class BetaThinkingTypes:`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
---
## api-java-beta-models-list-814d420b34.md
## List
`ModelListPage beta().models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams params`
- `Optional afterId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `Optional beforeId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Optional limit`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class BetaModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.ModelListPage;
import com.anthropic.models.beta.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.beta().models().list();
}
}
```
---
## api-java-beta-models-list.md
# List Models
ModelListPage beta().models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
ModelListParams params
Optional\ afterId
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
Optional\ beforeId
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Optional\ limit
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
Optional\\> betas
Optional header to specify the beta version(s) you want to use.
MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")
PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")
COMPUTER_USE_2024_10_22("computer-use-2024-10-22")
COMPUTER_USE_2025_01_24("computer-use-2025-01-24")
PDFS_2024_09_25("pdfs-2024-09-25")
TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")
TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")
OUTPUT_128K_2025_02_19("output-128k-2025-02-19")
FILES_API_2025_04_14("files-api-2025-04-14")
MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")
MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")
DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")
INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")
CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")
EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")
CONTEXT_1M_2025_08_07("context-1m-2025-08-07")
CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")
MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")
SKILLS_2025_10_02("skills-2025-10-02")
FAST_MODE_2026_02_01("fast-mode-2026-02-01")
##### ReturnsExpand Collapse
class BetaModelInfo:
String id
Unique model identifier.
Optional\<[BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)\> capabilities
Model capability information.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) effort
Effort (reasoning_effort) support and available levels.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) types
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
List Models
Java
```python
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.ModelListPage;
import com.anthropic.models.beta.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.beta().models().list();
}
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-java-beta-models-retrieve-b6b56b8585.md
## Retrieve
`BetaModelInfo beta().models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams params`
- `Optional modelId`
Model identifier or alias.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class BetaModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `BetaCapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaEffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `BetaCapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `BetaThinkingTypes types`
Supported thinking type configurations.
- `BetaCapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `BetaCapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.BetaModelInfo;
import com.anthropic.models.beta.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
BetaModelInfo betaModelInfo = client.beta().models().retrieve("model_id");
}
}
```
---
## api-java-beta-models-retrieve.md
# Get a Model
[BetaModelInfo](/docs/en/api/beta#beta_model_info) beta().models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
ModelRetrieveParams params
Optional\ modelId
Model identifier or alias.
Optional\\> betas
Optional header to specify the beta version(s) you want to use.
MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")
PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")
COMPUTER_USE_2024_10_22("computer-use-2024-10-22")
COMPUTER_USE_2025_01_24("computer-use-2025-01-24")
PDFS_2024_09_25("pdfs-2024-09-25")
TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")
TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")
OUTPUT_128K_2025_02_19("output-128k-2025-02-19")
FILES_API_2025_04_14("files-api-2025-04-14")
MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")
MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")
DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")
INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")
CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")
EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")
CONTEXT_1M_2025_08_07("context-1m-2025-08-07")
CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")
MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")
SKILLS_2025_10_02("skills-2025-10-02")
FAST_MODE_2026_02_01("fast-mode-2026-02-01")
##### ReturnsExpand Collapse
class BetaModelInfo:
String id
Unique model identifier.
Optional\<[BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)\> capabilities
Model capability information.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) effort
Effort (reasoning_effort) support and available levels.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) types
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
Get a Model
Java
```python
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.beta.models.BetaModelInfo;
import com.anthropic.models.beta.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
BetaModelInfo betaModelInfo = client.beta().models().retrieve("model_id");
}
}
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-java-beta-models.md
# Models
##### [List Models](/docs/en/api/beta/models/list)
ModelListPage beta().models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models
##### [Get a Model](/docs/en/api/beta/models/retrieve)
[BetaModelInfo](/docs/en/api/beta#beta_model_info) beta().models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models/{model_id}
##### ModelsExpand Collapse
class BetaCapabilitySupport:
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
class BetaContextManagementCapability:
Context management capability details.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
class BetaEffortCapability:
Effort (reasoning_effort) capability details.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
class BetaModelCapabilities:
Model capability information.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) effort
Effort (reasoning_effort) support and available levels.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) types
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
class BetaModelInfo:
String id
Unique model identifier.
Optional\<[BetaModelCapabilities](/docs/en/api/beta#beta_model_capabilities)\> capabilities
Model capability information.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[BetaContextManagementCapability](/docs/en/api/beta#beta_context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaEffortCapability](/docs/en/api/beta#beta_effort_capability) effort
Effort (reasoning_effort) support and available levels.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingCapability](/docs/en/api/beta#beta_thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) types
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
class BetaThinkingCapability:
Thinking capability details.
boolean supported
Whether this capability is supported by the model.
[BetaThinkingTypes](/docs/en/api/beta#beta_thinking_types) types
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
class BetaThinkingTypes:
Supported thinking type configurations.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[BetaCapabilitySupport](/docs/en/api/beta#beta_capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
---
## api-java-models-fd4e62202c.md
# Models
## List
`ModelListPage models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams params`
- `Optional afterId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `Optional beforeId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Optional limit`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class ModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelListPage;
import com.anthropic.models.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.models().list();
}
}
```
## Retrieve
`ModelInfo models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams params`
- `Optional modelId`
Model identifier or alias.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class ModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelInfo;
import com.anthropic.models.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelInfo modelInfo = client.models().retrieve("model_id");
}
}
```
## Domain Types
### Capability Support
- `class CapabilitySupport:`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
### Context Management Capability
- `class ContextManagementCapability:`
Context management capability details.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
### Effort Capability
- `class EffortCapability:`
Effort (reasoning_effort) capability details.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
### Model Capabilities
- `class ModelCapabilities:`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
### Model Info
- `class ModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Thinking Capability
- `class ThinkingCapability:`
Thinking capability details.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
### Thinking Types
- `class ThinkingTypes:`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
---
## api-java-models-list-25d15be48f.md
## List
`ModelListPage models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Parameters
- `ModelListParams params`
- `Optional afterId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `Optional beforeId`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `Optional limit`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class ModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelListPage;
import com.anthropic.models.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.models().list();
}
}
```
---
## api-java-models-list.md
# List Models
ModelListPage models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### ParametersExpand Collapse
ModelListParams params
Optional\ afterId
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
Optional\ beforeId
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
Optional\ limit
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
Optional\\> betas
Optional header to specify the beta version(s) you want to use.
MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")
PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")
COMPUTER_USE_2024_10_22("computer-use-2024-10-22")
COMPUTER_USE_2025_01_24("computer-use-2025-01-24")
PDFS_2024_09_25("pdfs-2024-09-25")
TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")
TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")
OUTPUT_128K_2025_02_19("output-128k-2025-02-19")
FILES_API_2025_04_14("files-api-2025-04-14")
MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")
MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")
DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")
INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")
CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")
EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")
CONTEXT_1M_2025_08_07("context-1m-2025-08-07")
CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")
MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")
SKILLS_2025_10_02("skills-2025-10-02")
FAST_MODE_2026_02_01("fast-mode-2026-02-01")
##### ReturnsExpand Collapse
class ModelInfo:
String id
Unique model identifier.
Optional\<[ModelCapabilities](/docs/en/api/models#model_capabilities)\> capabilities
Model capability information.
[CapabilitySupport](/docs/en/api/models#capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[ContextManagementCapability](/docs/en/api/models#context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[EffortCapability](/docs/en/api/models#effort_capability) effort
Effort (reasoning_effort) support and available levels.
[CapabilitySupport](/docs/en/api/models#capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[ThinkingCapability](/docs/en/api/models#thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[ThinkingTypes](/docs/en/api/models#thinking_types) types
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
List Models
Java
```python
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelListPage;
import com.anthropic.models.models.ModelListParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelListPage page = client.models().list();
}
}
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-java-models-retrieve-57894cb23e.md
## Retrieve
`ModelInfo models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Parameters
- `ModelRetrieveParams params`
- `Optional modelId`
Model identifier or alias.
- `Optional> betas`
Optional header to specify the beta version(s) you want to use.
- `MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")`
- `PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")`
- `COMPUTER_USE_2024_10_22("computer-use-2024-10-22")`
- `COMPUTER_USE_2025_01_24("computer-use-2025-01-24")`
- `PDFS_2024_09_25("pdfs-2024-09-25")`
- `TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")`
- `TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")`
- `OUTPUT_128K_2025_02_19("output-128k-2025-02-19")`
- `FILES_API_2025_04_14("files-api-2025-04-14")`
- `MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")`
- `MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")`
- `DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")`
- `INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")`
- `CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")`
- `EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")`
- `CONTEXT_1M_2025_08_07("context-1m-2025-08-07")`
- `CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")`
- `MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")`
- `SKILLS_2025_10_02("skills-2025-10-02")`
- `FAST_MODE_2026_02_01("fast-mode-2026-02-01")`
- `OUTPUT_300K_2026_03_24("output-300k-2026-03-24")`
- `ADVISOR_TOOL_2026_03_01("advisor-tool-2026-03-01")`
### Returns
- `class ModelInfo:`
- `String id`
Unique model identifier.
- `Optional capabilities`
Model capability information.
- `CapabilitySupport batch`
Whether the model supports the Batch API.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport citations`
Whether the model supports citation generation.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport codeExecution`
Whether the model supports code execution tools.
- `boolean supported`
Whether this capability is supported by the model.
- `ContextManagementCapability contextManagement`
Context management support and available strategies.
- `Optional clearThinking20251015`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional clearToolUses20250919`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `Optional compact20260112`
Indicates whether a capability is supported.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `EffortCapability effort`
Effort (reasoning_effort) support and available levels.
- `CapabilitySupport high`
Whether the model supports high effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport low`
Whether the model supports low effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport max`
Whether the model supports max effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport medium`
Whether the model supports medium effort level.
- `boolean supported`
Whether this capability is supported by the model.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport imageInput`
Whether the model accepts image content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport pdfInput`
Whether the model accepts PDF content blocks.
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport structuredOutputs`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingCapability thinking`
Thinking capability and supported type configurations.
- `boolean supported`
Whether this capability is supported by the model.
- `ThinkingTypes types`
Supported thinking type configurations.
- `CapabilitySupport adaptive`
Whether the model supports thinking with type 'adaptive' (auto).
- `boolean supported`
Whether this capability is supported by the model.
- `CapabilitySupport enabled`
Whether the model supports thinking with type 'enabled'.
- `boolean supported`
Whether this capability is supported by the model.
- `LocalDateTime createdAt`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `String displayName`
A human-readable name for the model.
- `Optional maxInputTokens`
Maximum input context window size in tokens for this model.
- `Optional maxTokens`
Maximum value for the `max_tokens` parameter when using this model.
- `JsonValue; type "model"constant`
Object type.
For Models, this is always `"model"`.
- `MODEL("model")`
### Example
```java
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelInfo;
import com.anthropic.models.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelInfo modelInfo = client.models().retrieve("model_id");
}
}
```
---
## api-java-models-retrieve.md
# Get a Model
[ModelInfo](/docs/en/api/models#model_info) models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### ParametersExpand Collapse
ModelRetrieveParams params
Optional\ modelId
Model identifier or alias.
Optional\\> betas
Optional header to specify the beta version(s) you want to use.
MESSAGE_BATCHES_2024_09_24("message-batches-2024-09-24")
PROMPT_CACHING_2024_07_31("prompt-caching-2024-07-31")
COMPUTER_USE_2024_10_22("computer-use-2024-10-22")
COMPUTER_USE_2025_01_24("computer-use-2025-01-24")
PDFS_2024_09_25("pdfs-2024-09-25")
TOKEN_COUNTING_2024_11_01("token-counting-2024-11-01")
TOKEN_EFFICIENT_TOOLS_2025_02_19("token-efficient-tools-2025-02-19")
OUTPUT_128K_2025_02_19("output-128k-2025-02-19")
FILES_API_2025_04_14("files-api-2025-04-14")
MCP_CLIENT_2025_04_04("mcp-client-2025-04-04")
MCP_CLIENT_2025_11_20("mcp-client-2025-11-20")
DEV_FULL_THINKING_2025_05_14("dev-full-thinking-2025-05-14")
INTERLEAVED_THINKING_2025_05_14("interleaved-thinking-2025-05-14")
CODE_EXECUTION_2025_05_22("code-execution-2025-05-22")
EXTENDED_CACHE_TTL_2025_04_11("extended-cache-ttl-2025-04-11")
CONTEXT_1M_2025_08_07("context-1m-2025-08-07")
CONTEXT_MANAGEMENT_2025_06_27("context-management-2025-06-27")
MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26("model-context-window-exceeded-2025-08-26")
SKILLS_2025_10_02("skills-2025-10-02")
FAST_MODE_2026_02_01("fast-mode-2026-02-01")
##### ReturnsExpand Collapse
class ModelInfo:
String id
Unique model identifier.
Optional\<[ModelCapabilities](/docs/en/api/models#model_capabilities)\> capabilities
Model capability information.
[CapabilitySupport](/docs/en/api/models#capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[ContextManagementCapability](/docs/en/api/models#context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[EffortCapability](/docs/en/api/models#effort_capability) effort
Effort (reasoning_effort) support and available levels.
[CapabilitySupport](/docs/en/api/models#capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[ThinkingCapability](/docs/en/api/models#thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[ThinkingTypes](/docs/en/api/models#thinking_types) types
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
Get a Model
Java
```python
package com.anthropic.example;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.models.ModelInfo;
import com.anthropic.models.models.ModelRetrieveParams;
public final class Main {
private Main() {}
public static void main(String[] args) {
AnthropicClient client = AnthropicOkHttpClient.fromEnv();
ModelInfo modelInfo = client.models().retrieve("model_id");
}
}
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-java-models.md
# Models
##### [List Models](/docs/en/api/models/list)
ModelListPage models().list(ModelListParamsparams = ModelListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models
##### [Get a Model](/docs/en/api/models/retrieve)
[ModelInfo](/docs/en/api/models#model_info) models().retrieve(ModelRetrieveParamsparams = ModelRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
GET/v1/models/{model_id}
##### ModelsExpand Collapse
class CapabilitySupport:
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
class ContextManagementCapability:
Context management capability details.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
class EffortCapability:
Effort (reasoning_effort) capability details.
[CapabilitySupport](/docs/en/api/models#capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
class ModelCapabilities:
Model capability information.
[CapabilitySupport](/docs/en/api/models#capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[ContextManagementCapability](/docs/en/api/models#context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[EffortCapability](/docs/en/api/models#effort_capability) effort
Effort (reasoning_effort) support and available levels.
[CapabilitySupport](/docs/en/api/models#capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[ThinkingCapability](/docs/en/api/models#thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[ThinkingTypes](/docs/en/api/models#thinking_types) types
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
class ModelInfo:
String id
Unique model identifier.
Optional\<[ModelCapabilities](/docs/en/api/models#model_capabilities)\> capabilities
Model capability information.
[CapabilitySupport](/docs/en/api/models#capability_support) batch
Whether the model supports the Batch API.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) citations
Whether the model supports citation generation.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) codeExecution
Whether the model supports code execution tools.
boolean supported
Whether this capability is supported by the model.
[ContextManagementCapability](/docs/en/api/models#context_management_capability) contextManagement
Context management support and available strategies.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearThinking20251015
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> clearToolUses20250919
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
Optional\<[CapabilitySupport](/docs/en/api/models#capability_support)\> compact20260112
Indicates whether a capability is supported.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[EffortCapability](/docs/en/api/models#effort_capability) effort
Effort (reasoning_effort) support and available levels.
[CapabilitySupport](/docs/en/api/models#capability_support) high
Whether the model supports high effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) low
Whether the model supports low effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) max
Whether the model supports max effort level.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) medium
Whether the model supports medium effort level.
boolean supported
Whether this capability is supported by the model.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) imageInput
Whether the model accepts image content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) pdfInput
Whether the model accepts PDF content blocks.
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) structuredOutputs
Whether the model supports structured output / JSON mode / strict tool schemas.
boolean supported
Whether this capability is supported by the model.
[ThinkingCapability](/docs/en/api/models#thinking_capability) thinking
Thinking capability and supported type configurations.
boolean supported
Whether this capability is supported by the model.
[ThinkingTypes](/docs/en/api/models#thinking_types) types
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
LocalDateTime createdAt
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
String displayName
A human-readable name for the model.
Optional\ maxInputTokens
Maximum input context window size in tokens for this model.
Optional\ maxTokens
Maximum value for the `max_tokens` parameter when using this model.
JsonValue; type "model"constant
"model"constant
Object type.
For Models, this is always `"model"`.
class ThinkingCapability:
Thinking capability details.
boolean supported
Whether this capability is supported by the model.
[ThinkingTypes](/docs/en/api/models#thinking_types) types
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
class ThinkingTypes:
Supported thinking type configurations.
[CapabilitySupport](/docs/en/api/models#capability_support) adaptive
Whether the model supports thinking with type 'adaptive' (auto).
boolean supported
Whether this capability is supported by the model.
[CapabilitySupport](/docs/en/api/models#capability_support) enabled
Whether the model supports thinking with type 'enabled'.
boolean supported
Whether this capability is supported by the model.
---
## api-kotlin-beta-models-list.md
---
## api-kotlin-beta-models-retrieve.md
---
## api-kotlin-beta-models.md
---
## api-kotlin-models-list.md
---
## api-kotlin-models-retrieve.md
---
## api-kotlin-models.md
---
## api-models-4198291c1d.md
# Models
## List
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Query Parameters
- `after_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `before_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `data: array of ModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: ModelCapabilities`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```http
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
## Retrieve
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Path Parameters
- `model_id: string`
Model identifier or alias.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `ModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: ModelCapabilities`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Example
```http
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
## Domain Types
### Capability Support
- `CapabilitySupport = object { supported }`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
### Context Management Capability
- `ContextManagementCapability = object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }`
Context management capability details.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Effort Capability
- `EffortCapability = object { high, low, max, 2 more }`
Effort (reasoning_effort) capability details.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
### Model Capabilities
- `ModelCapabilities = object { batch, citations, code_execution, 6 more }`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Model Info
- `ModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: ModelCapabilities`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Thinking Capability
- `ThinkingCapability = object { supported, types }`
Thinking capability details.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
### Thinking Types
- `ThinkingTypes = object { adaptive, enabled }`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
---
## api-models-4808ef942f.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fmodels)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
A beta version of this API exists and may have additional functionality. [View the beta version](/docs/en/api/http/beta/models).
1. [API reference](/docs/en/api/http)
# Models
##### [List Models](/docs/en/api/http/models/list)
GET/v1/models
List available models.
##### [Get a Model](/docs/en/api/http/models/retrieve)
GET/v1/models/{model_id}
Get a specific model.
##### Models
CapabilitySupport object{ supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
ContextManagementCapability object{ clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management capability details.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported } or null
Whether the clear_thinking_20251015 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported } or null
Whether the clear_tool_uses_20250919 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported } or null
Whether the compact_20260112 strategy is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
EffortCapability object{ high, low, max, 3 more }
Effort (reasoning_effort) capability details.
ModelCapabilities object{ batch, citations, code_execution, 6 more }
Model capability information.
ModelInfo object{ type: "model", id, capabilities, 4 more }
type: "model"
Object type.
For Models, this is always `"model"`.
defaultmodel
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/http/models#model_capabilities) { batch, citations, code_execution, 6 more } or null
Object mapping capability names to their support details. Keys are always present for all known capabilities.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
formatdate-time
display_name: string
A human-readable name for the model.
max_input_tokens: number or null
Maximum input context window size in tokens for this model.
max_tokens: number or null
Maximum value for the `max_tokens` parameter when using this model.
ThinkingCapability object{ supported, types }
Thinking capability details.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/http/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
ThinkingTypes object{ adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/http/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
---
## api-models-list-77e92174d5.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fmodels%2Flist)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
A beta version of this method exists and may have additional functionality. [View the beta version](/docs/en/api/http/beta/models/list).
1. [API reference](/docs/en/api/http)
2. [Models](/docs/en/api/http/models)
# List Models
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### Query parameters
after_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
before_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
default20
minimum1
maximum1000
##### Headers
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)Deprecated
Optional header to specify the beta version(s) you want to use.
Deprecated. This parameter will be removed from this method in a future release. To use beta features, call the beta models methods (\`client.beta.models\`) instead.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
##### Returns
data: array of [ModelInfo](/docs/en/api/http/models#model_info) { type: "model", id, capabilities, 4 more }
type: "model"
Object type.
For Models, this is always `"model"`.
defaultmodel
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/http/models#model_capabilities) { batch, citations, code_execution, 6 more } or null
Object mapping capability names to their support details. Keys are always present for all known capabilities.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
formatdate-time
display_name: string
A human-readable name for the model.
max_input_tokens: number or null
Maximum input context window size in tokens for this model.
max_tokens: number or null
Maximum value for the `max_tokens` parameter when using this model.
first_id: string or null
First ID in the `data` list. Can be used as the `before_id` for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string or null
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
cURL
```python
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-5",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-models-list-b413cb243d.md
## List
**get** `/v1/models`
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
### Query Parameters
- `after_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
- `before_id: optional string`
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
- `limit: optional number`
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `data: array of ModelInfo`
- `id: string`
Unique model identifier.
- `capabilities: ModelCapabilities`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
- `first_id: string`
First ID in the `data` list. Can be used as the `before_id` for the previous page.
- `has_more: boolean`
Indicates if there are more results in the requested page direction.
- `last_id: string`
Last ID in the `data` list. Can be used as the `after_id` for the next page.
### Example
```http
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
---
## api-models-list.md
# List Models
GET/v1/models
List available models.
The Models API response can be used to determine which models are available for use in the API. More recently released models are listed first.
##### Query ParametersExpand Collapse
after_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately after this object.
before_id: optional string
ID of the object to use as a cursor for pagination. When provided, returns the page of results immediately before this object.
limit: optional number
Number of items to return per page.
Defaults to `20`. Ranges from `1` to `1000`.
maximum1000
minimum1
##### Header ParametersExpand Collapse
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
Accepts one of the following:
UnionMember0 = string
UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more
Accepts one of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
##### ReturnsExpand Collapse
data: array of [ModelInfo](/docs/en/api/models#model_info) { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/models#model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [ContextManagementCapability](/docs/en/api/models#context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [EffortCapability](/docs/en/api/models#effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [ThinkingCapability](/docs/en/api/models#thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
first_id: string
First ID in the `data` list. Can be used as the `before_id` for the previous page.
has_more: boolean
Indicates if there are more results in the requested page direction.
last_id: string
Last ID in the `data` list. Can be used as the `after_id` for the next page.
List Models
cURL
```python
curl https://api.anthropic.com/v1/models \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
],
"first_id": "first_id",
"has_more": true,
"last_id": "last_id"
}
```
##### Returns Examples
Response 200
```python
{
"data": [
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-models-retrieve-340bf38c10.md
- [Managed Agents](/docs/en/managed-agents/overview)
- [Admin](/docs/en/manage-claude/admin-api)
- Resources
- [Best practices](/docs/en/about-claude/use-case-guides/overview)
- [Models & pricing](/docs/en/models/overview)
- [CLI, SDKs, and libraries](/docs/en/cli-sdks-libraries/overview)
- [Claude API skill](/docs/en/agents-and-tools/agent-skills/claude-api-skill)
- [Release notes](/docs/en/release-notes/overview)
[API reference](/docs/en/api/overview)
[Console](/)[Log in](/login?returnTo=%2Fdocs%2Fen%2Fapi%2Fmodels%2Fretrieve)
SearchCtrlK
Include beta APIs
Using the API
[Features overview](/docs/en/api/overview)[Beta headers](/docs/en/api/beta-headers)[Errors](/docs/en/api/errors)
Messages
Create a Message
Count tokens in a Message
Batches
Managed Agents
Agents
Environments
Sessions
Deployments
Deployment Runs
Vaults
Memory Stores
Dreams
Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
List Models
Get a Model
Skills
Create Skill
List Skills
Get Skill
Delete Skill
Versions
Organization
Get Current Organization
API Keys
External Keys
Federation
Invites
Service Accounts
Users
Workspaces
Rate Limits
Compliance Settings
Usage Report
Cost Report
MCP Tunnels
Analytics
Spend Limits
RBAC Groups
RBAC Roles
Tunnels
Create Tunnel
Get Tunnel
List Tunnels
Archive Tunnel
Reveal Tunnel Token
Rotate Tunnel Token
Certificates
User Profiles
Create User Profile
List User Profiles
Get User Profile
Update User Profile
Create Enrollment URL
Compliance API
Activities
Organizations
Groups
Apps
Code
Completions
Create a Text Completion
Support & configuration
[Rate limits](/docs/en/api/rate-limits)[Service tiers](/docs/en/api/service-tiers)[IAM actions (Claude Platform on AWS)](/docs/en/api/claude-platform-on-aws-iam-actions)[Versions](/docs/en/api/versioning)[IP addresses](/docs/en/api/ip-addresses)[Supported regions](/docs/en/api/supported-regions)
Claude Code
[Trigger a routine](/docs/en/api/claude-code/routines-fire)
[Console](/)
Copy page
cURL
A beta version of this method exists and may have additional functionality. [View the beta version](/docs/en/api/http/beta/models/retrieve).
1. [API reference](/docs/en/api/http)
2. [Models](/docs/en/api/http/models)
# Get a Model
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### Path parameters
model_id: string
Model identifier or alias.
##### Headers
"anthropic-workspace-id": optional string
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/http/beta#anthropic_beta)Deprecated
Optional header to specify the beta version(s) you want to use.
Deprecated. This parameter will be removed from this method in a future release. To use beta features, call the beta models methods (\`client.beta.models\`) instead.
One of the following:
string
"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 45 more
One of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
"output-300k-2026-03-24"
"user-profiles-2026-03-24"
"user-profiles-2026-08-18"
"user-profiles-2026-09-04"
"advisor-tool-2026-03-01"
"managed-agents-2026-04-01"
"cache-diagnosis-2026-04-07"
"dreaming-2026-04-21"
"thinking-token-count-2026-05-13"
"server-side-fallback-2026-06-01"
"server-side-fallback-2026-07-01"
"fallback-credit-2026-06-01"
"fallback-credit-2026-07-01"
"agent-memory-2026-07-22"
"mid-conversation-tool-changes-2026-07-01"
"compact-2026-01-12"
"computer-use-2025-11-24"
"mcp-tunnels-2026-06-22"
"structured-outputs-2025-11-13"
"task-budgets-2026-03-13"
"thinking-display-updates-2026-08-18"
"ce-user-management-2026-07-13"
"mid-conversation-output-config-2026-07-01"
"thinking-binding-controls-2026-08-01"
"mid-conversation-system-clear-at-2026-08-21"
"compact-2026-09-04"
"inline-tools-2026-09-15"
"mcp-client-2026-09-15"
##### Returns
ModelInfo object{ type: "model", id, capabilities, 4 more }
type: "model"
Object type.
For Models, this is always `"model"`.
defaultmodel
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/http/models#model_capabilities) { batch, citations, code_execution, 6 more } or null
Object mapping capability names to their support details. Keys are always present for all known capabilities.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
formatdate-time
display_name: string
A human-readable name for the model.
max_input_tokens: number or null
Maximum input context window size in tokens for this model.
max_tokens: number or null
Maximum value for the `max_tokens` parameter when using this model.
Get a Model
cURL
```python
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"id": "claude-opus-5",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-5",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true,
"xhigh": {
"supported": true
}
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-07-24T00:00:00Z",
"display_name": "Claude Opus 5",
---
## api-models-retrieve-3fb773e9f6.md
## Retrieve
**get** `/v1/models/{model_id}`
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
### Path Parameters
- `model_id: string`
Model identifier or alias.
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `UnionMember0 = string`
- `UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 19 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"advisor-tool-2026-03-01"`
### Returns
- `ModelInfo = object { id, capabilities, created_at, 4 more }`
- `id: string`
Unique model identifier.
- `capabilities: ModelCapabilities`
Model capability information.
- `batch: CapabilitySupport`
Whether the model supports the Batch API.
- `supported: boolean`
Whether this capability is supported by the model.
- `citations: CapabilitySupport`
Whether the model supports citation generation.
- `supported: boolean`
Whether this capability is supported by the model.
- `code_execution: CapabilitySupport`
Whether the model supports code execution tools.
- `supported: boolean`
Whether this capability is supported by the model.
- `context_management: ContextManagementCapability`
Context management support and available strategies.
- `clear_thinking_20251015: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `clear_tool_uses_20250919: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `compact_20260112: CapabilitySupport`
Indicates whether a capability is supported.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `effort: EffortCapability`
Effort (reasoning_effort) support and available levels.
- `high: CapabilitySupport`
Whether the model supports high effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `low: CapabilitySupport`
Whether the model supports low effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `max: CapabilitySupport`
Whether the model supports max effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `medium: CapabilitySupport`
Whether the model supports medium effort level.
- `supported: boolean`
Whether this capability is supported by the model.
- `supported: boolean`
Whether this capability is supported by the model.
- `image_input: CapabilitySupport`
Whether the model accepts image content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `pdf_input: CapabilitySupport`
Whether the model accepts PDF content blocks.
- `supported: boolean`
Whether this capability is supported by the model.
- `structured_outputs: CapabilitySupport`
Whether the model supports structured output / JSON mode / strict tool schemas.
- `supported: boolean`
Whether this capability is supported by the model.
- `thinking: ThinkingCapability`
Thinking capability and supported type configurations.
- `supported: boolean`
Whether this capability is supported by the model.
- `types: ThinkingTypes`
Supported thinking type configurations.
- `adaptive: CapabilitySupport`
Whether the model supports thinking with type 'adaptive' (auto).
- `supported: boolean`
Whether this capability is supported by the model.
- `enabled: CapabilitySupport`
Whether the model supports thinking with type 'enabled'.
- `supported: boolean`
Whether this capability is supported by the model.
- `created_at: string`
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
- `display_name: string`
A human-readable name for the model.
- `max_input_tokens: number`
Maximum input context window size in tokens for this model.
- `max_tokens: number`
Maximum value for the `max_tokens` parameter when using this model.
- `type: "model"`
Object type.
For Models, this is always `"model"`.
- `"model"`
### Example
```http
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
---
## api-models-retrieve.md
# Get a Model
GET/v1/models/{model_id}
Get a specific model.
The Models API response can be used to determine information about a specific model or resolve a model alias to a model ID.
##### Path ParametersExpand Collapse
model_id: string
Model identifier or alias.
##### Header ParametersExpand Collapse
"anthropic-beta": optional array of [AnthropicBeta](/docs/en/api/beta#anthropic_beta)
Optional header to specify the beta version(s) you want to use.
Accepts one of the following:
UnionMember0 = string
UnionMember1 = "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 17 more
Accepts one of the following:
"message-batches-2024-09-24"
"prompt-caching-2024-07-31"
"computer-use-2024-10-22"
"computer-use-2025-01-24"
"pdfs-2024-09-25"
"token-counting-2024-11-01"
"token-efficient-tools-2025-02-19"
"output-128k-2025-02-19"
"files-api-2025-04-14"
"mcp-client-2025-04-04"
"mcp-client-2025-11-20"
"dev-full-thinking-2025-05-14"
"interleaved-thinking-2025-05-14"
"code-execution-2025-05-22"
"extended-cache-ttl-2025-04-11"
"context-1m-2025-08-07"
"context-management-2025-06-27"
"model-context-window-exceeded-2025-08-26"
"skills-2025-10-02"
"fast-mode-2026-02-01"
##### ReturnsExpand Collapse
ModelInfo = object { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/models#model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [ContextManagementCapability](/docs/en/api/models#context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [EffortCapability](/docs/en/api/models#effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [ThinkingCapability](/docs/en/api/models#thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
Get a Model
cURL
```python
curl https://api.anthropic.com/v1/models/$MODEL_ID \
-H 'anthropic-version: 2023-06-01' \
-H "X-Api-Key: $ANTHROPIC_API_KEY"
```
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
"max_input_tokens": 0,
"max_tokens": 0,
"type": "model"
}
```
##### Returns Examples
Response 200
```python
{
"id": "claude-opus-4-6",
"capabilities": {
"batch": {
"supported": true
},
"citations": {
"supported": true
},
"code_execution": {
"supported": true
},
"context_management": {
"clear_thinking_20251015": {
"supported": true
},
"clear_tool_uses_20250919": {
"supported": true
},
"compact_20260112": {
"supported": true
},
"supported": true
},
"effort": {
"high": {
"supported": true
},
"low": {
"supported": true
},
"max": {
"supported": true
},
"medium": {
"supported": true
},
"supported": true
},
"image_input": {
"supported": true
},
"pdf_input": {
"supported": true
},
"structured_outputs": {
"supported": true
},
"thinking": {
"supported": true,
"types": {
"adaptive": {
"supported": true
},
"enabled": {
"supported": true
}
}
}
},
"created_at": "2026-02-04T00:00:00Z",
"display_name": "Claude Opus 4.6",
---
## api-models.md
# Models
##### [List Models](/docs/en/api/models/list)
GET/v1/models
##### [Get a Model](/docs/en/api/models/retrieve)
GET/v1/models/{model_id}
##### ModelsExpand Collapse
CapabilitySupport = object { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
ContextManagementCapability = object { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management capability details.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
EffortCapability = object { high, low, max, 2 more }
Effort (reasoning_effort) capability details.
high: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
ModelCapabilities = object { batch, citations, code_execution, 6 more }
Model capability information.
batch: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [ContextManagementCapability](/docs/en/api/models#context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [EffortCapability](/docs/en/api/models#effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [ThinkingCapability](/docs/en/api/models#thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
ModelInfo = object { id, capabilities, created_at, 4 more }
id: string
Unique model identifier.
capabilities: [ModelCapabilities](/docs/en/api/models#model_capabilities) { batch, citations, code_execution, 6 more }
Model capability information.
batch: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports the Batch API.
supported: boolean
Whether this capability is supported by the model.
citations: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports citation generation.
supported: boolean
Whether this capability is supported by the model.
code_execution: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports code execution tools.
supported: boolean
Whether this capability is supported by the model.
context_management: [ContextManagementCapability](/docs/en/api/models#context_management_capability) { clear_thinking_20251015, clear_tool_uses_20250919, compact_20260112, supported }
Context management support and available strategies.
clear_thinking_20251015: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
clear_tool_uses_20250919: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
compact_20260112: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Indicates whether a capability is supported.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
effort: [EffortCapability](/docs/en/api/models#effort_capability) { high, low, max, 2 more }
Effort (reasoning_effort) support and available levels.
high: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports high effort level.
supported: boolean
Whether this capability is supported by the model.
low: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports low effort level.
supported: boolean
Whether this capability is supported by the model.
max: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports max effort level.
supported: boolean
Whether this capability is supported by the model.
medium: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports medium effort level.
supported: boolean
Whether this capability is supported by the model.
supported: boolean
Whether this capability is supported by the model.
image_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts image content blocks.
supported: boolean
Whether this capability is supported by the model.
pdf_input: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model accepts PDF content blocks.
supported: boolean
Whether this capability is supported by the model.
structured_outputs: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports structured output / JSON mode / strict tool schemas.
supported: boolean
Whether this capability is supported by the model.
thinking: [ThinkingCapability](/docs/en/api/models#thinking_capability) { supported, types }
Thinking capability and supported type configurations.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
created_at: string
RFC 3339 datetime string representing the time at which the model was released. May be set to an epoch value if the release date is unknown.
display_name: string
A human-readable name for the model.
max_input_tokens: number
Maximum input context window size in tokens for this model.
max_tokens: number
Maximum value for the `max_tokens` parameter when using this model.
type: "model"
Object type.
For Models, this is always `"model"`.
ThinkingCapability = object { supported, types }
Thinking capability details.
supported: boolean
Whether this capability is supported by the model.
types: [ThinkingTypes](/docs/en/api/models#thinking_types) { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
ThinkingTypes = object { adaptive, enabled }
Supported thinking type configurations.
adaptive: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'adaptive' (auto).
supported: boolean
Whether this capability is supported by the model.
enabled: [CapabilitySupport](/docs/en/api/models#capability_support) { supported }
Whether the model supports thinking with type 'enabled'.
supported: boolean
Whether this capability is supported by the model.
---
## api-php-beta-models-bc11debf5f.md
Not Found - Claude API Docs
Loading...
---
## api-php-beta-models-list-a1aa4ff86a.md
Not Found - Claude API Docs
Loading...
---
## api-php-beta-models-list.md
---
*Truncated: 172 more documents not shown (size limit)*