Skip to main content
POST
/
spotlight
/
anthropic
/
v1
/
messages
/
count_tokens
Count Tokens
curl --request POST \
  --url https://api.app.shinzo.ai/spotlight/anthropic/v1/messages/count_tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "messages": [
    {}
  ]
}
'

​
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.

​
Authentication

Requires JWT token or Platform API key. Same format as the Messages API, but the request is not executed:
​
model
string
required
Model to use for tokenization
​
messages
array
required
Array 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