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 的代幣

定價和速率限制

常見問題

代幣計算是否使用提示快取？