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-5puede usarse para Messages Token Count, al igual que el último modelo insigniaclaude-fable-5-1; el anteriorclaude-fable-5sigue siendo compatible y se conserva.claude-sonnet-5-5se 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 contienerole(rol) ycontent(contenido).
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.
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
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 bibliotecaanthropic. 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
usagede la respuesta real de Messages. - Las imágenes, PDF, definiciones de herramientas, prompts del sistema y la configuración
thinkingse 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.

