Constructor Detail

Method Detail

• body

   final MessageCountTokensParams.Builder body(MessageCountTokensParams.Body body)

  Sets the entire request body.

  This is generally only useful if you are already constructing the body separately. Otherwise, it's more convenient to use the top-level setters instead:

  • messages

  • model

  • system

  • thinking

  • toolChoice

  • etc.

• messages

   final MessageCountTokensParams.Builder messages(List<MessageParam> messages)

  Input messages.

  Our models are trained to operate on alternating user and assistant conversational turns. When creating a new Message, you specify the prior conversational turns with the messages parameter, and the model then generates the next Message in the conversation. Consecutive user or assistant turns in your request will be combined into a single turn.

  Each input message must be an object with a role and content. You can specify a single user-role message, or you can include multiple user and assistant messages.

  If the final message uses the assistant role, the response content will continue immediately from the content in that message. This can be used to constrain part of the model's response.

  Example with a single user message:

  [{ "role": "user", "content": "Hello, Claude" }]

  Example with multiple conversational turns:

  [
    { "role": "user", "content": "Hello there." },
    { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
    { "role": "user", "content": "Can you explain LLMs in plain English?" }
  ]

  Example with a partially-filled response from Claude:

  [
    {
      "role": "user",
      "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"
    },
    { "role": "assistant", "content": "The best answer is (" }
  ]

  Each input message content may be either a single string or an array of content blocks, where each block has a specific type. Using a string for content is shorthand for an array of one content block of type "text". The following input messages are equivalent:

  { "role": "user", "content": "Hello, Claude" }

  { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }

  Starting with Claude 3 models, you can also send image content blocks:

  {
    "role": "user",
    "content": [
      {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/jpeg",
          "data": "/9j/4AAQSkZJRg..."
        }
      },
      { "type": "text", "text": "What is in this image?" }
    ]
  }

  We currently support the base64 source type for images, and the image/jpeg, image/png, image/gif, and image/webp media types.

  See examples for more input examples.

  Note that if you want to include a system prompt, you can use the top-level system parameter — there is no "system" role for input messages in the Messages API.

  There is a limit of 100000 messages in a single request.

• messages

   final MessageCountTokensParams.Builder messages(JsonField<List<MessageParam>> messages)

  Sets Builder.messages to an arbitrary JSON value.

  You should usually call Builder.messages with a well-typed List<MessageParam> value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• addMessage

   final MessageCountTokensParams.Builder addMessage(MessageParam message)

  Adds a single MessageParam to messages.

• addMessage

   final MessageCountTokensParams.Builder addMessage(Message message)

  Alias for calling addMessage with message.toParam().

• addUserMessage

   final MessageCountTokensParams.Builder addUserMessage(MessageParam.Content content)

  Alias for calling addMessage with the following:

  MessageParam.builder()
      .role(MessageParam.Role.USER)
      .content(content)
      .build()

• addUserMessage

   final MessageCountTokensParams.Builder addUserMessage(String string)

  Alias for calling addUserMessage with MessageParam.Content.ofString(string).

• addUserMessageOfBlockParams

   final MessageCountTokensParams.Builder addUserMessageOfBlockParams(List<ContentBlockParam> blockParams)

  Alias for calling addUserMessage with MessageParam.Content.ofBlockParams(blockParams).

• addAssistantMessage

   final MessageCountTokensParams.Builder addAssistantMessage(MessageParam.Content content)

  Alias for calling addMessage with the following:

  MessageParam.builder()
      .role(MessageParam.Role.ASSISTANT)
      .content(content)
      .build()

• addAssistantMessage

   final MessageCountTokensParams.Builder addAssistantMessage(String string)

  Alias for calling addAssistantMessage with MessageParam.Content.ofString(string).

• addAssistantMessageOfBlockParams

   final MessageCountTokensParams.Builder addAssistantMessageOfBlockParams(List<ContentBlockParam> blockParams)

  Alias for calling addAssistantMessage with MessageParam.Content.ofBlockParams(blockParams).

• model

   final MessageCountTokensParams.Builder model(Model model)

  The model that will complete your prompt.\n\nSee models for additional details and options.

• model

   final MessageCountTokensParams.Builder model(JsonField<Model> model)

  Sets Builder.model to an arbitrary JSON value.

  You should usually call Builder.model with a well-typed Model value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• model

   final MessageCountTokensParams.Builder model(String value)

  Sets model to an arbitrary String.

  You should usually call model with a well-typed Model constant instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• system

   final MessageCountTokensParams.Builder system(MessageCountTokensParams.System system)

  System prompt.

  A system prompt is a way of providing context and instructions to Claude, such as specifying a particular goal or role. See our guide to system prompts.

• system

   final MessageCountTokensParams.Builder system(JsonField<MessageCountTokensParams.System> system)

  Sets Builder.system to an arbitrary JSON value.

  You should usually call Builder.system with a well-typed System value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• system

   final MessageCountTokensParams.Builder system(String string)

  Alias for calling system with System.ofString(string).

• systemOfTextBlockParams

   final MessageCountTokensParams.Builder systemOfTextBlockParams(List<TextBlockParam> textBlockParams)

  Alias for calling system with System.ofTextBlockParams(textBlockParams).

• thinking

   final MessageCountTokensParams.Builder thinking(ThinkingConfigParam thinking)

  Configuration for enabling Claude's extended thinking.

  When enabled, responses include thinking content blocks showing Claude's thinking process before the final answer. Requires a minimum budget of 1,024 tokens and counts towards your max_tokens limit.

  See extended thinking for details.

• thinking

   final MessageCountTokensParams.Builder thinking(JsonField<ThinkingConfigParam> thinking)

  Sets Builder.thinking to an arbitrary JSON value.

  You should usually call Builder.thinking with a well-typed ThinkingConfigParam value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• thinking

   final MessageCountTokensParams.Builder thinking(ThinkingConfigEnabled enabled)

  Alias for calling thinking with ThinkingConfigParam.ofEnabled(enabled).

• thinking

   final MessageCountTokensParams.Builder thinking(ThinkingConfigDisabled disabled)

  Alias for calling thinking with ThinkingConfigParam.ofDisabled(disabled).

• enabledThinking

   final MessageCountTokensParams.Builder enabledThinking(Long budgetTokens)

  Alias for calling thinking with the following:

  ThinkingConfigEnabled.builder()
      .budgetTokens(budgetTokens)
      .build()

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(ToolChoice toolChoice)

  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.

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(JsonField<ToolChoice> toolChoice)

  Sets Builder.toolChoice to an arbitrary JSON value.

  You should usually call Builder.toolChoice with a well-typed ToolChoice value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(ToolChoiceAuto auto)

  Alias for calling toolChoice with ToolChoice.ofAuto(auto).

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(ToolChoiceAny any)

  Alias for calling toolChoice with ToolChoice.ofAny(any).

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(ToolChoiceTool tool)

  Alias for calling toolChoice with ToolChoice.ofTool(tool).

• toolChoice

   final MessageCountTokensParams.Builder toolChoice(ToolChoiceNone none)

  Alias for calling toolChoice with ToolChoice.ofNone(none).

• toolToolChoice

   final MessageCountTokensParams.Builder toolToolChoice(String name)

  Alias for calling toolChoice with the following:

  ToolChoiceTool.builder()
      .name(name)
      .build()

• tools

   final MessageCountTokensParams.Builder tools(List<MessageCountTokensTool> 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.

  Each tool definition includes:

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

  For example, if you defined tools as:

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

  And then asked the model "What's the S&P 500 at today?", the model might produce tool_use content blocks in the response like this:

  [
    {
      "type": "tool_use",
      "id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
      "name": "get_stock_price",
      "input": { "ticker": "^GSPC" }
    }
  ]

  You might then run your get_stock_price tool with {"ticker": "^GSPC"} as an input, and return the following back to the model in a subsequent user message:

  [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01D7FLrfh4GYq7yT1ULFeyMV",
      "content": "259.75 USD"
    }
  ]

  Tools can be used for workflows that include running client-side tools and functions, or more generally whenever you want the model to produce a particular JSON structure of output.

  See our guide for more details.

• tools

   final MessageCountTokensParams.Builder tools(JsonField<List<MessageCountTokensTool>> tools)

  Sets Builder.tools to an arbitrary JSON value.

  You should usually call Builder.tools with a well-typed List<MessageCountTokensTool> value instead. This method is primarily for setting the field to an undocumented or not yet supported value.

• addTool

   final MessageCountTokensParams.Builder addTool(MessageCountTokensTool tool)

  Adds a single MessageCountTokensTool to tools.

• addTool

   final MessageCountTokensParams.Builder addTool(Tool tool)

  Alias for calling addTool with MessageCountTokensTool.ofTool(tool).

• addTool

   final MessageCountTokensParams.Builder addTool(ToolBash20250124 toolBash20250124)

  Alias for calling addTool with MessageCountTokensTool.ofToolBash20250124(toolBash20250124).

• addTool

   final MessageCountTokensParams.Builder addTool(ToolTextEditor20250124 toolTextEditor20250124)

  Alias for calling addTool with MessageCountTokensTool.ofToolTextEditor20250124(toolTextEditor20250124).

• addTool

   final MessageCountTokensParams.Builder addTool(MessageCountTokensTool.TextEditor20250429 textEditor20250429)

  Alias for calling addTool with MessageCountTokensTool.ofTextEditor20250429(textEditor20250429).

• addTool

   final MessageCountTokensParams.Builder addTool(WebSearchTool20250305 webSearchTool20250305)

  Alias for calling addTool with MessageCountTokensTool.ofWebSearchTool20250305(webSearchTool20250305).

• additionalBodyProperties

   final MessageCountTokensParams.Builder additionalBodyProperties(Map<String, JsonValue> additionalBodyProperties)

• putAdditionalBodyProperty

   final MessageCountTokensParams.Builder putAdditionalBodyProperty(String key, JsonValue value)

• putAllAdditionalBodyProperties

   final MessageCountTokensParams.Builder putAllAdditionalBodyProperties(Map<String, JsonValue> additionalBodyProperties)

• removeAdditionalBodyProperty

   final MessageCountTokensParams.Builder removeAdditionalBodyProperty(String key)

• removeAllAdditionalBodyProperties

   final MessageCountTokensParams.Builder removeAllAdditionalBodyProperties(Set<String> keys)

• additionalHeaders

   final MessageCountTokensParams.Builder additionalHeaders(Headers additionalHeaders)

• additionalHeaders

   final MessageCountTokensParams.Builder additionalHeaders(Map<String, Iterable<String>> additionalHeaders)

• putAdditionalHeader

   final MessageCountTokensParams.Builder putAdditionalHeader(String name, String value)

• putAdditionalHeaders

   final MessageCountTokensParams.Builder putAdditionalHeaders(String name, Iterable<String> values)

• putAllAdditionalHeaders

   final MessageCountTokensParams.Builder putAllAdditionalHeaders(Headers additionalHeaders)

• putAllAdditionalHeaders

   final MessageCountTokensParams.Builder putAllAdditionalHeaders(Map<String, Iterable<String>> additionalHeaders)

• replaceAdditionalHeaders

   final MessageCountTokensParams.Builder replaceAdditionalHeaders(String name, String value)

• replaceAdditionalHeaders

   final MessageCountTokensParams.Builder replaceAdditionalHeaders(String name, Iterable<String> values)

• replaceAllAdditionalHeaders

   final MessageCountTokensParams.Builder replaceAllAdditionalHeaders(Headers additionalHeaders)

• replaceAllAdditionalHeaders

   final MessageCountTokensParams.Builder replaceAllAdditionalHeaders(Map<String, Iterable<String>> additionalHeaders)

• removeAdditionalHeaders

   final MessageCountTokensParams.Builder removeAdditionalHeaders(String name)

• removeAllAdditionalHeaders

   final MessageCountTokensParams.Builder removeAllAdditionalHeaders(Set<String> names)

• additionalQueryParams

   final MessageCountTokensParams.Builder additionalQueryParams(QueryParams additionalQueryParams)

• additionalQueryParams

   final MessageCountTokensParams.Builder additionalQueryParams(Map<String, Iterable<String>> additionalQueryParams)

• putAdditionalQueryParam

   final MessageCountTokensParams.Builder putAdditionalQueryParam(String key, String value)

• putAdditionalQueryParams

   final MessageCountTokensParams.Builder putAdditionalQueryParams(String key, Iterable<String> values)

• putAllAdditionalQueryParams

   final MessageCountTokensParams.Builder putAllAdditionalQueryParams(QueryParams additionalQueryParams)

• putAllAdditionalQueryParams

   final MessageCountTokensParams.Builder putAllAdditionalQueryParams(Map<String, Iterable<String>> additionalQueryParams)

• replaceAdditionalQueryParams

   final MessageCountTokensParams.Builder replaceAdditionalQueryParams(String key, String value)

• replaceAdditionalQueryParams

   final MessageCountTokensParams.Builder replaceAdditionalQueryParams(String key, Iterable<String> values)

• replaceAllAdditionalQueryParams

   final MessageCountTokensParams.Builder replaceAllAdditionalQueryParams(QueryParams additionalQueryParams)

• replaceAllAdditionalQueryParams

   final MessageCountTokensParams.Builder replaceAllAdditionalQueryParams(Map<String, Iterable<String>> additionalQueryParams)

• removeAdditionalQueryParams

   final MessageCountTokensParams.Builder removeAdditionalQueryParams(String key)

• removeAllAdditionalQueryParams

   final MessageCountTokensParams.Builder removeAllAdditionalQueryParams(Set<String> keys)

• build

   final MessageCountTokensParams build()

  Returns an immutable instance of MessageCountTokensParams.

  Further updates to this Builder will not mutate the returned instance.

  The following fields are required:

  .messages()
  .model()