Skip to main content
POST
/
v3
/
compat
/
v1beta
/
models
/
{model}
:countTokens
Count Tokens API
curl --request POST \
  --url https://api.opper.ai/v3/compat/v1beta/models/{model}:countTokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": "<unknown>",
  "input": "<unknown>"
}
'
{
  "totalTokens": 123,
  "cachedContentTokenCount": 123
}

Authorizations

​
Authorization
string
header
required

API key authentication. Pass your API key as a Bearer token.

Headers

​
X-Opper-Name
string

Function name for tracing and project-level guardrail function-scope filtering.

​
X-Opper-Parent-Span-Id
string<uuid>

Parent span ID for distributed tracing context.

Path Parameters

​
model
string
required

Model id — a bare Gemini name (e.g. gemini-2.5-flash, resolved against the Gemini-direct provider) or an Opper-canonical id (e.g. vertexai/gemini-2.5-flash).

Body

application/json
​
contents
any
required

Any value

​
input
any
required

Any value

​
agent
string
​
background
boolean
​
custom_model_credentials
object
​
generation_config
object
​
model
string
​
previous_interaction_id
string
​
response_format
object
​
response_mime_type
string
​
safety_settings
object[]
​
store
boolean
​
stream
boolean
​
system_instruction
object
​
tool_config
object
​
tools
object[]

Response

Successful response

​
totalTokens
integer
required
​
cachedContentTokenCount
integer