Count Tokens API
POST https://api.synthetic.new/anthropic/v1/messages/count_tokensCount the number of input tokens in a set of messages before sending them to a model.
Tip
/messages/count_tokens requests do not count against your subscription limits!
Subscriber Feature
This endpoint is currently available to subscribers only.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model name (must be prefixed with hf:). See supported Models. |
messages | array | Yes | Array of message objects to count tokens for |
Message Object
| Parameter | Type | Required | Description |
|---|---|---|---|
role | string | Yes | Role: user or assistant |
content | string | Yes | Message content (text only for the /count_tokens endpoint) |
Example Usage
- Python
- TypeScript
- curl
import anthropic
client = anthropic.Anthropic(
api_key="SYNTHETIC_API_KEY",
base_url="https://api.synthetic.new/anthropic/v1"
)
# Count tokens for a simple text message
response = client.messages.count_tokens(
model="hf:deepseek-ai/DeepSeek-V3-0324",
messages=[
{"role": "user", "content": "What is the capital of France?"}
]
)
print(f"Input tokens: {response.input_tokens}")Example Response
- json
{
"input_tokens": 20
}