The upgraded Claude 3.7 Sonnet model is capable of calling tools in a token-efficient manner. Requests save an average of 14% in output tokens, up to 70%, which also reduces latency. Exact token reduction and latency improvements depend on the overall response shape and size.

Token-efficient tool use is a beta feature. Please make sure to evaluate your responses before using it in production.

Please use this form to provide feedback on the quality of the model responses, the API itself, or the quality of the documentation—we cannot wait to hear from you!

If you choose to experiment with this feature, we recommend using the Prompt Improver in the Console to improve your prompt.

Token-efficient tool use does not currently work with disable_parallel_tool_use.

To use this beta feature, simply add the beta header token-efficient-tools-2025-02-19 to a tool use request with claude-3-7-sonnet-20250219. If you are using the SDK, ensure that you are using the beta SDK with anthropic.beta.messages.

Here’s an example of how to use token-efficient tools with the API:

The above request should, on average, use fewer input and output tokens than a normal request. To confirm this, try making the same request but remove token-efficient-tools-2025-02-19 from the beta headers list.

To keep the benefits of prompt caching, use the beta header consistently for requests you’d like to cache. If you selectively use it, prompt caching will fail.

Was this page helpful?