Class AnthropicTokenCountEstimator.Builder

java.lang.Object

dev.langchain4j.model.anthropic.AnthropicTokenCountEstimator.Builder

Enclosing class:

AnthropicTokenCountEstimator

public static class AnthropicTokenCountEstimator.Builder
extends Object

Since:

1.4.0

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
AnthropicTokenCountEstimator.Builder	addDummyUserMessageIfNoUserMessages()	Configures the estimator to automatically insert a minimal dummy user message ("ping") when the provided messages contain only system messages or are empty.
AnthropicTokenCountEstimator.Builder	addDummyUserMessageIfNoUserMessages(String dummyUserMessage)	Configures the estimator to automatically insert a dummy user message with custom text when the provided messages contain only system messages or are empty.
AnthropicTokenCountEstimator.Builder	apiKey(String apiKey)	Sets the Anthropic API key used to authenticate requests.
AnthropicTokenCountEstimator.Builder	baseUrl(String baseUrl)	Sets the base URL of the Anthropic API.
AnthropicTokenCountEstimator.Builder	beta(String beta)	Sets the value of the anthropic-beta request header to opt into beta features.
AnthropicTokenCountEstimator	build()
AnthropicTokenCountEstimator.Builder	httpClientBuilder(HttpClientBuilder httpClientBuilder)	Sets a custom HttpClientBuilder for the underlying HTTP client.
AnthropicTokenCountEstimator.Builder	logRequests(Boolean logRequests)	Enables debug logging of HTTP request bodies sent to the Anthropic API.
AnthropicTokenCountEstimator.Builder	logResponses(Boolean logResponses)	Enables debug logging of HTTP response bodies received from the Anthropic API.
AnthropicTokenCountEstimator.Builder	modelName(AnthropicChatModelName modelName)	Sets the model used for token count estimation using a type-safe enum constant.
AnthropicTokenCountEstimator.Builder	modelName(String modelName)	Sets the model used for token count estimation, specified as a string model ID.
AnthropicTokenCountEstimator.Builder	timeout(Duration timeout)	Sets the HTTP request timeout for calls to the Anthropic API.
AnthropicTokenCountEstimator.Builder	version(String version)	Sets the value of the anthropic-version request header.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

public Builder()

Method Details

httpClientBuilder

public AnthropicTokenCountEstimator.Builder httpClientBuilder(HttpClientBuilder httpClientBuilder)

Sets a custom HttpClientBuilder for the underlying HTTP client. Use this to configure timeouts, proxies, or other HTTP-level settings.

Parameters:

httpClientBuilder - the HTTP client builder

Returns:

this

baseUrl

public AnthropicTokenCountEstimator.Builder baseUrl(String baseUrl)

Sets the base URL of the Anthropic API.

Defaults to https://api.anthropic.com/v1/.

Parameters:

baseUrl - the base URL

Returns:

this

apiKey

public AnthropicTokenCountEstimator.Builder apiKey(String apiKey)

Sets the Anthropic API key used to authenticate requests.

Alternatively, set the ANTHROPIC_API_KEY environment variable.

Parameters:

apiKey - the API key

Returns:

this

version

public AnthropicTokenCountEstimator.Builder version(String version)

Sets the value of the anthropic-version request header.

Defaults to 2023-06-01. See the Anthropic API versioning docs.

Parameters:

version - the API version string

Returns:

this

beta

public AnthropicTokenCountEstimator.Builder beta(String beta)

Sets the value of the anthropic-beta request header to opt into beta features.

See the Anthropic beta headers docs.

Parameters:

beta - the beta feature identifier

Returns:

this

timeout

public AnthropicTokenCountEstimator.Builder timeout(Duration timeout)

Sets the HTTP request timeout for calls to the Anthropic API.

Parameters:

timeout - the request timeout

Returns:

this

logRequests

public AnthropicTokenCountEstimator.Builder logRequests(Boolean logRequests)

Enables debug logging of HTTP request bodies sent to the Anthropic API.

Parameters:

logRequests - whether to log requests

Returns:

this

logResponses

public AnthropicTokenCountEstimator.Builder logResponses(Boolean logResponses)

Enables debug logging of HTTP response bodies received from the Anthropic API.

Parameters:

logResponses - whether to log responses

Returns:

this

modelName

public AnthropicTokenCountEstimator.Builder modelName(String modelName)

Sets the model used for token count estimation, specified as a string model ID.

This field is required. See AnthropicChatModelName for available model constants.

Parameters:

modelName - the model ID, e.g. "claude-opus-4-5"

Returns:

this

modelName

public AnthropicTokenCountEstimator.Builder modelName(AnthropicChatModelName modelName)

Sets the model used for token count estimation using a type-safe enum constant.

This field is required.

Parameters:

modelName - the model name enum value

Returns:

this

addDummyUserMessageIfNoUserMessages

public AnthropicTokenCountEstimator.Builder addDummyUserMessageIfNoUserMessages()

Configures the estimator to automatically insert a minimal dummy user message ("ping") when the provided messages contain only system messages or are empty.

The Anthropic token-counting API requires at least one non-system message. Without this option, passing only system messages throws an IllegalArgumentException.

Returns:

this

See Also:

• addDummyUserMessageIfNoUserMessages(String)

addDummyUserMessageIfNoUserMessages

public AnthropicTokenCountEstimator.Builder addDummyUserMessageIfNoUserMessages(String dummyUserMessage)

Configures the estimator to automatically insert a dummy user message with custom text when the provided messages contain only system messages or are empty.

The Anthropic token-counting API requires at least one non-system message. Without this option, passing only system messages throws an IllegalArgumentException.

Parameters:

dummyUserMessage - the text of the dummy user message to insert

Returns:

this

See Also:

• addDummyUserMessageIfNoUserMessages()

build

public AnthropicTokenCountEstimator build()