Solicitud y uso de la API Claude Messages Count Tokens

Claude AI API guide - Ace Data Cloud

La API Claude Messages Count Tokens puede calcular la cantidad de Tokens de entrada de un Message sin crear realmente mensajes, incluyendo el conteo de Tokens de contenidos como herramientas, imágenes y documentos. Esto es muy útil cuando se necesita estimar costos o comprobar si la entrada excede el límite de contexto del modelo.

Este documento presenta principalmente el proceso de uso de la API Claude Messages Count Tokens.

​

Proceso de solicitud

Para usar la API Claude Messages Count Tokens, primero vaya a la consola de Ace Data Cloud para obtener su API Token y guárdelo como respaldo.

Si aún no ha iniciado sesión o se ha registrado, será redirigido automáticamente a la página de inicio de sesión para invitarle a registrarse e iniciar sesión; al completarlo, regresará automáticamente a la página actual.

Un solo API Token puede invocar todos los servicios de la plataforma, sin necesidad de solicitar uno por separado para cada servicio. La primera solicitud incluirá crédito gratuito, lo que permite una experiencia sin costo; cuando el crédito sea insuficiente, puede recargar saldo general en la consola.

📘 Documentación completa: Claude Messages Count Tokens API →

​

Uso básico

La ruta de solicitud de la API Claude Messages Count Tokens es /v1/messages/count_tokens, y se mantiene coherente con la API oficial de Anthropic. Necesitamos proporcionar al menos dos parámetros obligatorios:

• model: seleccione el modelo Claude que se utilizará; claude-opus-5-5 puede usarse para Messages Token Count, como el último modelo insignia claude-fable-5-1; el anterior claude-fable-5 sigue siendo compatible y se conserva.
• messages: el arreglo de mensajes de entrada, donde cada mensaje contiene role (rol) y content (contenido).

Parámetros opcionales comunes:

• system: prompt del sistema, que se incluirá en la cantidad de Tokens.
• tools: definiciones de herramientas, que se incluirán 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é de nivel superior o de bloque de contenido.

messages, system, la reproducción de llamadas a herramientas, las imágenes URL y los bloques de contenido document/PDF utilizan la misma estructura de solicitud estable que la API 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 Claude Messages Count Tokens acepta la estructura de solicitud estable del SDK de Anthropic y puede invocarse mediante la biblioteca anthropic. La interfaz utiliza la capacidad nativa de Count Tokens correspondiente al modelo seleccionado para contar la entrada, y puede utilizarse para comprobar el tamaño de la entrada antes de enviar una solicitud Messages.

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 con herramientas incluidas

Si su solicitud incluye definiciones de herramientas, estas herramientas también se incluirá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 con prompt del sistema incluido

El prompt del sistema también se incluirá 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)

​

Notas

• Esta API solo calcula la cantidad de Tokens de entrada y no generará ninguna salida del modelo.
• El resultado del conteo de Tokens puede utilizarse para estimar el tamaño de entrada y comprobar la ventana de contexto; la facturación final se basará en el usage de la respuesta real de Messages.
• Las imágenes, PDF, definiciones de herramientas, prompts del sistema y configuraciones de thinking se incluirán en el resultado conforme a las reglas de entrada del modelo seleccionado.
• Esta API es completamente gratuita y no consume ningún crédito.