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": [
    {}
  ]
}
'

POST

spotlight

anthropic

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:

string

required

Model to use for tokenization

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

Code	Description
`200`	Success
`400`	Invalid request
`401`	Invalid authentication
`403`	Provider key not found

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Count Tokens

Count Tokens

Authentication

Example Request

Response

Caching

Timeout

Status Codes

​Count Tokens

​Authentication

​Example Request

​Response

​Caching

​Timeout

​Status Codes

Count Tokens

Authentication

Example Request

Response

Caching

Timeout

Status Codes