Saltar al contenido principal
Contenido actualizado: 2026-06-09

Conteo de tokens de Claude

Se utiliza para estimar cuántos tokens se consumirán en la parte de entrada antes de llamar realmente a POST /v1/messages. Es adecuado para Claude CLI, Claude Code, control de presupuesto o lógica de recorte de contexto.

Autenticación

Se recomienda usar los encabezados de solicitud estilo Anthropic:
También se puede usar autenticación estándar Bearer, pero los clientes del ecosistema Anthropic normalmente llevan el encabezado anterior.

Cuerpo de la solicitud

El cuerpo de la solicitud sigue el estilo de Claude Messages. Los campos mínimos normalmente son:
  • model
  • messages
Si la solicitud incluye system, tools, resultados de herramientas o contenido de texto, estos también se incluirán en la estimación.

Ejemplo de solicitud

Ejemplo de respuesta

Campos de retorno

Limitaciones

La implementación actual estima principalmente:
  • El texto de system
  • El contenido de texto en messages
  • Texto/JSON en las definiciones y resultados de herramientas
Si la solicitud incluye imágenes o archivos, esta API no cuenta los tokens de las imágenes/archivos en input_tokens. En este caso, podría aparecer warning en la respuesta, y el costo real será mayor que el valor estimado aquí.
Esta API devuelve un valor estimado, no el valor final de facturación. El consumo real se basa en el resultado del llamado al modelo.

Páginas relacionadas