Skip to content
SayGMDocs
Dashboard

Count tokens for an Anthropic Messages request

POST
/messages/count_tokens
curl --request POST \
--url https://api.saygm.com/v1/messages/count_tokens \
--header 'Content-Type: application/json' \
--header 'anthropic-version: 2023-06-01' \
--header 'x-api-key: <x-api-key>' \
--data '{ "model": "example" }'

Count input tokens for a Messages request. The gateway validates the model id, requires anthropic-version, and returns the upstream token count without charging inference usage.

anthropic-version
required
string
>= 1 characters
Example
2023-06-01

Anthropic API version. The gateway rejects a missing or blank value before routing.

Media typeapplication/json
object
model
required

Canonical model id returned by /v1/models.

string
key
additional properties
any
Examplegenerated
{
"model": "example"
}

The token count.

Media typeapplication/json
object
input_tokens
required
integer
key
additional properties
any
Examplegenerated
{
"input_tokens": 1
}

Invalid request or model, content processing enabled for this key, or an upstream provider 400 response.

Media typeapplication/json
object
type
required
string
Allowed value: error
error
required
object
type
required
string
message
required
string
key
additional properties
any
request_id

Gateway request identifier.

string
key
additional properties
any
Example
{
"type": "error"
}

The API key is missing or invalid.

Media typeapplication/json
object
type
required
string
Allowed value: error
error
required
object
type
required
string
message
required
string
key
additional properties
any
request_id

Gateway request identifier.

string
key
additional properties
any
Example
{
"type": "error"
}

Account, model, or upstream request limit. OpenAI-shaped account-limit errors use rate_limit_exceeded.

Media typeapplication/json
Any of:

OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.

object
error
required
object
message
required
string
type
required
string
code
required

Machine-readable error code. Account request limits use rate_limit_exceeded.

string
param
required
string | null
request_id

Gateway request identifier.

string
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
cost_ndollars

Settled charge in nano-dollars; present when billing_status is settled.

integer
Example
{
"billing_status": "settled"
}
Retry-After
integer
>= 1

Seconds before retrying, when a delay is available.

Upstream connection failure (upstream_connect_failed).

Media typeapplication/json
Any of:

OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.

object
error
required
object
message
required
string
type
required
string
code
required

Machine-readable error code. Account request limits use rate_limit_exceeded.

string
param
required
string | null
request_id

Gateway request identifier.

string
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
cost_ndollars

Settled charge in nano-dollars; present when billing_status is settled.

integer
Example
{
"billing_status": "settled"
}

The credit service, guardrail policy, or model serving is unavailable.

Media typeapplication/json
Any of:

OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.

object
error
required
object
message
required
string
type
required
string
code
required

Machine-readable error code. Account request limits use rate_limit_exceeded.

string
param
required
string | null
request_id

Gateway request identifier.

string
charged
boolean
billing_status
string
Allowed values: settled unbilled unknown
potentially_charged
boolean
cost_ndollars

Settled charge in nano-dollars; present when billing_status is settled.

integer
Example
{
"billing_status": "settled"
}
Retry-After
integer
>= 1

Seconds before retrying, when a delay is available.