Count Message Token

User Interface

Dataflow

Field	Description	Comment
Model	The model that will complete your prompt.	See models for additional details and options.
Messages	Input messages.	Refer to "How to make Messages?" section below this page.
System	System prompt (Optional)
Tools	Definitions of tools that the model may use. (Optional)	Refer to "What is Tools?" below this page.
Tools Choice	How the model should use the provided tools. (Optional)	Refer to "What is Tools Choice?" below this page.

How to make Messages?

The message content is structured as an array of message objects, and each message follows the format below.

Key	Description	Comment
content	Message Content
role	Message Role	user: Represents the message or question sent by the user to the AI—this is the actual input the AI should respond to. assistant: Represents the AI model’s response to the user’s input.

Message Context Example:

[
  {
    "role": "assistant",                       // AI's sample response
    "content": "Hello! How can I help you today?"
  },
  {
    "role": "user",                            // User request to the AI
    "content": "Could you explain what an automation workflow is, in English?"
  }
]

What is Tools?

Definitions of tools that the model may use.

If you include tools in your API request, the model may return tool_use content blocks that represent the model's use of those tools. You can then run those tools using the tool input generated by the model and then optionally return results back to the model using tool_result content blocks.

Key	Description	Comment
name	Name of the tool.
description	Optional, but strongly-recommended description of the tool.
input_schema	JSON schema for the tool input shape that the model will produce in tool_use output content blocks.

Example:

[
  {
    "name": "get_stock_price",
    "description": "Get the current stock price for a given ticker symbol.",
    "input_schema": {
      "type": "object",
      "properties": {
        "ticker": {
          "type": "string",
          "description": "The stock ticker symbol, e.g. AAPL for Apple Inc."
        }
      },
      "required": ["ticker"]
    }
  }
]

What is Tool Choice?

How the model should use the provided tools. The model can use a specific tool, any available tool, decide by itself, or not use tools at all.

Key	Description	Comment
auto	Automatically selected by the model based on context
any	Freely select from the provided tools
tool	Force the use of a specific tool only

Example:

// When selecting auto or any
{
  "type": "auto" // or "any"
}

// To enforce the use of a specific tool
// For example, if the tool named "get_stock_price" is specified
{
  "type": "tool",
  "tool": {
    "name": "get_stock_price" // Only the get_stock_price tool will be used
  }
}

Response Datas

Key	Description
input_tokens	The total number of tokens across the provided list of messages, system prompt, and tools.