Saltar al contenido principal
La API Claude Messages Count Tokens puede calcular la cantidad de Tokens de entrada de un Message sin crear realmente un mensaje, incluido el conteo de Tokens de contenido como herramientas, imágenes y documentos. Esto es muy útil cuando se necesita estimar costos o verificar 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 ve a la Consola de Ace Data Cloud para obtener tu API Token y guárdalo como respaldo. Si aún no has iniciado sesión o te has registrado, serás redirigido automáticamente a la página de inicio de sesión para invitarte a registrarte e iniciar sesión; al completarlo, regresarás automáticamente a la página actual. Un API Token puede llamar a todos los servicios de la plataforma, sin necesidad de solicitar uno por separado para cada servicio. La primera solicitud incluirá crédito gratuito, permitiendo una experiencia gratuita; cuando el crédito sea insuficiente, puedes recargar el 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 consistente con la API oficial de Anthropic. Como mínimo, necesitamos proporcionar dos parámetros obligatorios:
  • model: selecciona el modelo Claude que se utilizará; claude-opus-5-5 puede usarse para Messages Token Count, al igual que el último modelo insignia claude-fable-5-1; el anterior claude-fable-5 sigue siendo compatible y se conserva. claude-sonnet-5-5 se ha añadido a la interfaz nativa de la serie Messages, con soporte para entrada de imágenes y pensamiento adaptativo; sus precios oficiales de referencia para entrada, salida y lectura de caché son respectivamente 2, 10 y 0.20 dólares por millón de Tokens.
  • messages: el array 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: definición de herramientas, que se incluirá 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.
Los bloques de contenido de messages, system, reproducción de llamadas de herramientas, imágenes URL y documentos/PDF utilizan la misma estructura de solicitud estable que la API Messages.

Ejemplo de cURL

Ejemplo de Python

Ejemplo de resultado devuelto:

Uso del SDK de Anthropic

La API Claude Messages Count Tokens acepta la estructura de solicitud estable del SDK de Anthropic y puede llamarse mediante la biblioteca anthropic. La interfaz utiliza la capacidad nativa Count Tokens correspondiente al modelo seleccionado para contar la entrada, y puede usarse para verificar el tamaño de la entrada antes de enviar una solicitud Messages.

Conteo de Tokens que incluye herramientas

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

Conteo de Tokens que incluye prompts del sistema

Los prompts del sistema también se incluirán en la cantidad de Tokens:

Consideraciones

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