Token 计数

构建上下文管理

令牌计数

在发送消息到 Claude 之前确定消息中的令牌数量

令牌计数使您能够在将消息发送到 Claude 之前确定消息中的令牌数量，帮助您对提示和使用做出明智的决定。通过令牌计数，您可以

主动管理速率限制和成本
做出聪明的模型路由决策
优化提示以达到特定长度

This feature is eligible for Zero Data Retention (ZDR). When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

如何计数消息令牌

令牌计数端点接受与创建消息相同的结构化输入列表，包括对系统提示、工具、图像和 PDF 的支持。响应包含输入令牌的总数。

令牌计数应被视为估计值。在某些情况下，创建消息时实际使用的输入令牌数量可能会略有不同。

令牌计数可能包括 Anthropic 为系统优化自动添加的令牌。您不会为系统添加的令牌付费。计费仅反映您的内容。

支持的模型

所有活跃模型都支持令牌计数。

计数基本消息中的令牌

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())

Output

{ "input_tokens": 14 }

计数包含工具的消息中的令牌

服务器工具令牌计数仅适用于第一次采样调用。

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    }
                },
                "required": ["location"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())

Output

{ "input_tokens": 403 }

计数包含图像的消息中的令牌

import base64
import httpx

image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image_media_type = "image/jpeg"
image_data = base64.standard_b64encode(httpx.get(image_url).content).decode("utf-8")

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image_media_type,
                        "data": image_data,
                    },
                },
                {"type": "text", "text": "Describe this image"},
            ],
        }
    ],
)
print(response.json())

Output

{ "input_tokens": 1551 }

在消息中使用扩展思考计数令牌

查看扩展思考如何计算上下文窗口了解更多详情

来自之前助手轮次的思考块被忽略，不计入您的输入令牌
当前助手轮次的思考确实计入您的输入令牌

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-sonnet-4-6",
    thinking={"type": "enabled", "budget_tokens": 16000},
    messages=[
        {
            "role": "user",
            "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?",
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "thinking",
                    "thinking": "This is a nice number theory question. Let's think about it step by step...",
                    "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV...",
                },
                {
                    "type": "text",
                    "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3...",
                },
            ],
        },
        {"role": "user", "content": "Can you write a formal proof?"},
    ],
)

print(response.json())

Output

{ "input_tokens": 88 }

在消息中使用 PDF 计数令牌

令牌计数支持 PDF，具有与 Messages API 相同的限制。

import base64
import anthropic

client = anthropic.Anthropic()

with open("document.pdf", "rb") as pdf_file:
    pdf_base64 = base64.standard_b64encode(pdf_file.read()).decode("utf-8")

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                },
                {"type": "text", "text": "Please summarize this document."},
            ],
        }
    ],
)

print(response.json())

Output

{ "input_tokens": 2188 }

定价和速率限制

令牌计数免费使用，但受到基于您的使用层级的每分钟请求数速率限制。如果您需要更高的限制，请通过 Claude Console 联系销售。

使用层级	每分钟请求数 (RPM)
1	100
2	2,000
3	4,000
4	8,000

令牌计数和消息创建具有独立的速率限制。一个的使用不会计入另一个的限制。

常见问题

Was this page helpful?

构建上下文管理

令牌计数

在发送消息到 Claude 之前确定消息中的令牌数量

令牌计数使您能够在将消息发送到 Claude 之前确定消息中的令牌数量，帮助您对提示和使用做出明智的决定。通过令牌计数，您可以

主动管理速率限制和成本
做出聪明的模型路由决策
优化提示以达到特定长度

This feature is eligible for Zero Data Retention (ZDR). When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

如何计数消息令牌

令牌计数端点接受与创建消息相同的结构化输入列表，包括对系统提示、工具、图像和 PDF 的支持。响应包含输入令牌的总数。

令牌计数应被视为估计值。在某些情况下，创建消息时实际使用的输入令牌数量可能会略有不同。

令牌计数可能包括 Anthropic 为系统优化自动添加的令牌。您不会为系统添加的令牌付费。计费仅反映您的内容。

支持的模型

所有活跃模型都支持令牌计数。

计数基本消息中的令牌

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())

Output

{ "input_tokens": 14 }

计数包含工具的消息中的令牌

服务器工具令牌计数仅适用于第一次采样调用。

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    }
                },
                "required": ["location"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())

Output

{ "input_tokens": 403 }

计数包含图像的消息中的令牌

import base64
import httpx

image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image_media_type = "image/jpeg"
image_data = base64.standard_b64encode(httpx.get(image_url).content).decode("utf-8")

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image_media_type,
                        "data": image_data,
                    },
                },
                {"type": "text", "text": "Describe this image"},
            ],
        }
    ],
)
print(response.json())

Output

{ "input_tokens": 1551 }

在消息中使用扩展思考计数令牌

查看扩展思考如何计算上下文窗口了解更多详情

来自之前助手轮次的思考块被忽略，不计入您的输入令牌
当前助手轮次的思考确实计入您的输入令牌

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-sonnet-4-6",
    thinking={"type": "enabled", "budget_tokens": 16000},
    messages=[
        {
            "role": "user",
            "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?",
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "thinking",
                    "thinking": "This is a nice number theory question. Let's think about it step by step...",
                    "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV...",
                },
                {
                    "type": "text",
                    "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3...",
                },
            ],
        },
        {"role": "user", "content": "Can you write a formal proof?"},
    ],
)

print(response.json())

Output

{ "input_tokens": 88 }

在消息中使用 PDF 计数令牌

令牌计数支持 PDF，具有与 Messages API 相同的限制。

import base64
import anthropic

client = anthropic.Anthropic()

with open("document.pdf", "rb") as pdf_file:
    pdf_base64 = base64.standard_b64encode(pdf_file.read()).decode("utf-8")

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                },
                {"type": "text", "text": "Please summarize this document."},
            ],
        }
    ],
)

print(response.json())

Output

{ "input_tokens": 2188 }

定价和速率限制

令牌计数免费使用，但受到基于您的使用层级的每分钟请求数速率限制。如果您需要更高的限制，请通过 Claude Console 联系销售。

使用层级	每分钟请求数 (RPM)
1	100
2	2,000
3	4,000
4	8,000

令牌计数和消息创建具有独立的速率限制。一个的使用不会计入另一个的限制。

常见问题

Was this page helpful?

如何计数消息令牌

支持的模型

计数基本消息中的令牌

计数包含工具的消息中的令牌

计数包含图像的消息中的令牌

在消息中使用扩展思考计数令牌

在消息中使用 PDF 计数令牌

定价和速率限制

常见问题

令牌计数是否使用提示缓存？

如何计数消息令牌

支持的模型

计数基本消息中的令牌

计数包含工具的消息中的令牌

计数包含图像的消息中的令牌

在消息中使用扩展思考计数令牌

在消息中使用 PDF 计数令牌

定价和速率限制

常见问题

令牌计数是否使用提示缓存？