Skip to main content
POST
/
spotlight
/
anthropic
/
v1
/
messages
/
count_tokens
Count Tokens
curl --request POST \
  --url https://api.example.com/spotlight/anthropic/v1/messages/count_tokens

​
Count Tokens

Count the number of input tokens that a request would use without actually sending it to the model. Useful for estimating costs and managing context windows.

​
Endpoint

POST /spotlight/anthropic/v1/messages/count_tokens

​
Authentication

Requires JWT token or Platform API key.

​
Request Body

Same format as the Messages API, but the request is not executed:
FieldTypeRequiredDescription
modelstringYesModel to use for tokenization
messagesarrayYesArray of message objects

​
Example Request

curl -X POST https://api.app.shinzo.ai/spotlight/anthropic/v1/messages/count_tokens \
  -H "Authorization: Bearer <jwt_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'

​
Response

{
  "input_tokens": 14
}

​
Caching

Token counts support caching with the following TTLs:
  • Ephemeral 5m: Cached for 5 minutes
  • Ephemeral 1h: Cached for 1 hour

​
Timeout

Request timeout is 30 seconds.

​
Status Codes

CodeDescription
200Success
400Invalid request
401Invalid authentication
403Provider key not found