Solicitud y uso de la API de Conteo de Tokens de Claude Messages

La API de Conteo de Tokens de Claude Messages puede calcular la cantidad de tokens de entrada de un mensaje sin crear realmente el mensaje, incluyendo el conteo de tokens de herramientas, imágenes y documentos. Esto es muy útil cuando se necesita estimar costos o verificar si la entrada excede los límites de contexto del modelo. Este documento describe principalmente el proceso de uso de la API de Conteo de Tokens de Claude Messages.

Proceso de Solicitud

Para usar la API de Conteo de Tokens de Claude Messages, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, que debes guardar como respaldo.

Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, regresarás automáticamente a la página actual. Un token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud te otorgará un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.

📘 Documentación completa: API de Conteo de Tokens de Claude Messages →

Uso Básico

La ruta de solicitud de la API de Conteo de Tokens de Claude Messages es /v1/messages/count_tokens, manteniendo la consistencia con la API oficial de Anthropic. Necesitamos proporcionar al menos dos parámetros obligatorios:

model: seleccionar el modelo de Claude a utilizar, como el último modelo insignia claude-fable-5-1; el antiguo claude-fable-5 sigue siendo compatible.
messages: un array de mensajes de entrada, cada mensaje incluye role (rol) y content (contenido).

Parámetros opcionales comunes:

system: mensaje del sistema, que se contabiliza en la cantidad de tokens.
tools: definición de herramientas, que se contabiliza en la cantidad de tokens.
thinking: configuración de pensamiento extendido.
tool_choice: configuración de selección de herramientas.
cache_control: configuración de control de caché a nivel de bloque de contenido o de nivel superior.

messages, system, la reproducción de llamadas a herramientas, imágenes URL y bloques de contenido de documentos/PDF utilizan la misma estructura de solicitud estable que la API de Messages.

Ejemplo de cURL

curl -X POST 'https://api.acedata.cloud/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-fable-5-1",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

Ejemplo de Python

import httpx

url = "https://api.acedata.cloud/v1/messages/count_tokens"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}
payload = {
    "model": "claude-fable-5-1",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())

Ejemplo de resultado devuelto:

{
  "input_tokens": 11
}

Uso del SDK de Anthropic

La API de Conteo de Tokens de Claude Messages acepta la estructura de solicitud estable del SDK de Anthropic y se puede invocar a través de la biblioteca anthropic. El valor devuelto actualmente es calculado por el estimador local de Ace Data Cloud y no es el resultado preciso del tokenizador oficial de Anthropic; el número real de tokens para multimodal, herramientas y diferentes modelos de Claude puede variar.

from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.acedata.cloud",
)

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
)
print(result.input_tokens)

Conteo de Tokens que Incluyen Herramientas

Si tu solicitud incluye definiciones de herramientas, estas herramientas también se contabilizarán en la cantidad de tokens:

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "What is the weather in San Francisco?"
        }
    ],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    }
                },
                "required": ["location"]
            }
        }
    ],
)
print(result.input_tokens)

Conteo de Tokens que Incluyen Mensajes del Sistema

Los mensajes del sistema también se contabilizarán en la cantidad de tokens:

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

Consideraciones

Esta API solo calcula la cantidad de tokens de entrada y no generará ninguna salida del modelo.
Los resultados del conteo de tokens pueden usarse para estimar de manera aproximada la escala de entrada, y no deben considerarse como base para facturación precisa, control de acceso a la ventana de contexto o comparación con el tokenizador del modelo.
El estimador actual no calculará con precisión los tokens visuales/documentales de imágenes y PDF, ni reflejará las diferencias del tokenizador oficial de los diferentes modelos de Claude.
Esta API es completamente gratuita y no consume ningún crédito.

Primeros pasos

Chat de IA

Imagen de IA

Video de IA

Audio de IA

Web y datos

CAPTCHA

Identidad

Proxy

Avanzado

Coding

Solicitud y uso de la API de Conteo de Tokens de Claude Messages

Proceso de Solicitud

Uso Básico

Ejemplo de cURL

Ejemplo de Python

Uso del SDK de Anthropic

Conteo de Tokens que Incluyen Herramientas

Conteo de Tokens que Incluyen Mensajes del Sistema

Consideraciones

​Proceso de Solicitud

​Uso Básico

​Ejemplo de cURL

​Ejemplo de Python

​Uso del SDK de Anthropic

​Conteo de Tokens que Incluyen Herramientas

​Conteo de Tokens que Incluyen Mensajes del Sistema

​Consideraciones

Proceso de Solicitud

Uso Básico

Ejemplo de cURL

Ejemplo de Python

Uso del SDK de Anthropic

Conteo de Tokens que Incluyen Herramientas

Conteo de Tokens que Incluyen Mensajes del Sistema

Consideraciones