v10

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0643140398.0 KB
Messages
Messages

Count tokens in a Message

Count tokens in a Message

post/v1/messages/count_tokens

Request body

modelstring required

Model identifier or alias.

Example request

{
  "messages": [
    {
      "content": "Count tokens for this input.",
      "role": "user"
    }
  ],
  "model": "default",
  "system": [
    {
      "text": "You are a tokenizer."
    }
  ],
  "thinking": {
    "enabled": false
  },
  "tool_choice": {
    "disable_parallel_tool_use": false,
    "type": "auto",
    "validation_mode": "lazy"
  },
  "tools": [
    {
      "description": "Get current weather for a city.",
      "inputSchema": {
        "properties": {
          "city": {
            "description": "City name.",
            "type": "string"
          }
        },
        "required": [
          "city"
        ],
        "type": "object"
      },
      "name": "get_weather"
    }
  ]
}

Response

Successful Response

input_tokensinteger required

Estimated number of input tokens for the provided payload.