Precio de la API de Claude: cuánto cuesta y cómo calcular tu gasto

Publicado el 21 de octubre de 2026 · Precios comprobados el 21 de octubre de 2026 · 11 min de lectura · Por el equipo de Master en Claude · Blog MasterEnClaude

¿Vas a construir algo con la API de Claude y quieres saber cuánto te va a costar antes de poner la tarjeta? La duda es lógica: la API no tiene una cuota fija al mes, sino que cobra por lo que usas, y eso al principio da un poco de vértigo.

En esta guía te explico cómo se cobra, cuánto cuesta cada modelo y cuánto saldría un proyecto real con números. También verás cómo pagar bastante menos con dos funciones que casi nadie usa al empezar.

Cómo cobra la API de Claude: tokens de entrada y de salida

Un token es un trozo de texto: a veces una palabra entera y a veces parte de una palabra o un signo. La API cuenta los tokens de cada petición y te cobra por dos conceptos:

• Tokens de entrada (input): todo lo que envías. Eso incluye tu mensaje, el system prompt, el historial de la conversación, los documentos, las imágenes y las definiciones de herramientas (tools).
• Tokens de salida (output): todo lo que genera el modelo. Ojo: también se cobra lo que Claude «piensa» antes de responder. Según la documentación de Anthropic, los tokens de razonamiento se facturan como tokens de salida, aunque no veas todo ese razonamiento en la respuesta.

Los precios se expresan por millón de tokens (MTok). La fórmula de cada petición es sencilla:

coste = (tokens_entrada / 1.000.000 × precio_entrada)
      + (tokens_salida  / 1.000.000 × precio_salida)

Dos detalles que conviene saber desde el principio:

1. La salida es cinco veces más cara que la entrada en todos los modelos actuales. Las respuestas largas encarecen más que los prompts largos.
2. Los modelos recientes cuentan más tokens por el mismo texto. Anthropic indica que, desde Claude Opus 4.7, el nuevo tokenizer genera aproximadamente un 30 % más de tokens que los modelos anteriores con el mismo texto. Si comparas con cálculos antiguos, vuelve a contar.

Precios de la API de Claude por modelo (octubre de 2026)

Estos son los precios oficiales de la página de precios de Anthropic, comprobados el 21 de octubre de 2026. Están en dólares estadounidenses (USD) y son por millón de tokens:

Otros datos que pueden afectar a tu presupuesto:

• Contexto de 1 millón de tokens en los cuatro modelos, y hasta 128.000 tokens de salida por petición. Según Anthropic, en Sonnet, Opus y Fable una petición de 900.000 tokens paga lo mismo por token que una de 9.000. Haiku 5.5 es la excepción: si el prompt pasa de 100.000 tokens, la petición entera se cobra a la tarifa alta.
• Modo rápido (fast mode) de Opus 5.5: respuestas mucho más rápidas a $8 de entrada y $40 de salida.
• Inferencia solo en EE. UU. (inference_geo: "us"): multiplica todos los precios por 1,1.
• Búsqueda web (web search): $10 por cada 1.000 búsquedas, más los tokens de los resultados. La herramienta web fetch no tiene coste adicional aparte de los tokens.
• Herramientas (tool use): las definiciones de tus tools cuentan como tokens de entrada. Además, la API añade un pequeño system prompt interno (unos 286 tokens en Sonnet 5.5 y Opus 5.5).

Los precios cambian con cada generación de modelos. Antes de presupuestar algo importante, consulta siempre la página oficial.

Ejemplo real: cuánto cuesta un asistente con 1.000 consultas al día

Pongamos un caso típico: un asistente de atención al cliente en tu web.

• 1.000 consultas al día, 30 días al mes.
• Cada consulta envía unos 1.500 tokens de entrada (instrucciones, historial y pregunta) y recibe unos 400 de salida.
• Al mes son 45 millones de tokens de entrada y 12 millones de salida.

Una sola consulta con Sonnet 5.5 cuesta 1.500 × $2/1 M + 400 × $10/1 M = $0,007, menos de un centavo de dólar.

Conclusiones prácticas:

• Para tareas sencillas y de gran volumen, empieza por Haiku. La diferencia de precio es enorme. Si la calidad no llega, sube a Sonnet.
• El razonamiento cuenta como salida. En la tabla he supuesto 400 tokens de salida, pero si el modelo razona antes de responder, la salida real puede ser mayor. Mídelo en tus pruebas (más abajo te enseño cómo).
• Son estimaciones. Tu coste real depende de la longitud de tus prompts y respuestas.

Cómo pagar menos: caché de prompts, Batch API y esfuerzo

1. Caché de prompts (prompt caching)

Si envías una y otra vez el mismo bloque largo (unas instrucciones, un manual o un catálogo), puedes guardarlo en caché. Así, la API no lo procesa entero en cada petición. Según la documentación oficial:

• Escribir en la caché de 5 minutos cuesta 1,25 veces el precio de entrada. La caché de 1 hora cuesta 2 veces.
• Leer de la caché cuesta muy poco: el 5 % del precio de entrada en Sonnet 5.5 y Opus 5.5, el 2,5 % en Fable 5.1 y el 10 % en Haiku 5.5.

Ejemplo con números. Imagina 20.000 tokens de instrucciones y documentación que se repiten en 1.000 peticiones al día con Sonnet 5.5:

• Sin caché: 20 millones de tokens × $2 = $40 al día.
• Con caché (suponiendo que las peticiones llegan a menudo y la caché no caduca): una escritura de unos $0,05 y 999 lecturas que suman unos $2. En total, unos $2 al día. Un 95 % menos en esa parte del prompt.

La forma más sencilla de activarla es la caché automática: añades un único campo cache_control en el nivel superior de la petición y el sistema gestiona el resto. Tienes los detalles en la documentación de prompt caching.

2. Batch API: 50 % de descuento

Si no necesitas la respuesta al momento (procesar 5.000 fichas de producto, clasificar correos de la semana o resumir documentos por la noche), la Batch API procesa las peticiones de forma asíncrona con un 50 % de descuento en entrada y salida. Por ejemplo, Sonnet 5.5 pasa a $1 de entrada y $5 de salida.

El descuento de Batch y el de la caché se pueden combinar.

3. Ajusta el esfuerzo (effort)

Los modelos actuales deciden cuánto razonar en cada petición, y ese razonamiento se paga como salida. Puedes guiarlo con el parámetro effort. Para tareas rutinarias, un esfuerzo bajo consume menos tokens:

import anthropic

cliente = anthropic.Anthropic()

respuesta = cliente.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    output_config={"effort": "low"},  # menos razonamiento, menos coste
    messages=[{"role": "user", "content": "Clasifica este correo: ¿queja, duda o pedido?"}],
)
print(respuesta.content[0].text)

Algunos datos sobre effort:

• El valor por defecto es high en Sonnet 5.5 y Fable 5.1, y medium en Opus 5.5 y Haiku 5.5.
• max_tokens es un límite duro de toda la salida: incluye el razonamiento y el texto de la respuesta.
• Baja el esfuerzo solo después de comprobar en tus pruebas que la calidad se mantiene.

Calcula tu gasto con Python, antes y después de cada llamada

Antes: cuenta los tokens gratis

Anthropic ofrece un endpoint para contar tokens antes de enviar la petición. Es gratuito, aunque tiene límites de peticiones por minuto:

import anthropic

cliente = anthropic.Anthropic()  # lee la clave de la variable ANTHROPIC_API_KEY

conteo = cliente.messages.count_tokens(
    model="claude-sonnet-5-5",
    system="Eres un asistente de atención al cliente. Respondes en español.",
    messages=[{"role": "user", "content": "¿Cuánto tarda en llegar un pedido a Bogotá?"}],
)
print(conteo.input_tokens)

Cuenta siempre con el mismo modelo que vas a usar: el número de tokens cambia entre generaciones.

Después: calcula el coste real con usage

Cada respuesta de la API trae un objeto usage con los tokens que se han facturado. Con este pequeño script sabes cuánto te ha costado cada llamada:

import anthropic

# USD por millón de tokens. Precios comprobados el 21/10/2026 en la web de Anthropic.
PRECIOS = {
    "claude-haiku-5-5":  {"entrada": 0.10,  "salida": 0.50,  "lectura_cache": 0.10},   # prompts de hasta 100k tokens
    "claude-sonnet-5-5": {"entrada": 2.00,  "salida": 10.00, "lectura_cache": 0.05},
    "claude-opus-5-5":   {"entrada": 4.00,  "salida": 20.00, "lectura_cache": 0.05},
    "claude-fable-5-1":  {"entrada": 10.00, "salida": 50.00, "lectura_cache": 0.025},
}
ESCRITURA_CACHE_5MIN = 1.25  # multiplicador sobre el precio de entrada

def coste_usd(modelo: str, usage) -> float:
    p = PRECIOS[modelo]
    entrada   = usage.input_tokens * p["entrada"]
    escritura = (usage.cache_creation_input_tokens or 0) * p["entrada"] * ESCRITURA_CACHE_5MIN
    lectura   = (usage.cache_read_input_tokens or 0) * p["entrada"] * p["lectura_cache"]
    salida    = usage.output_tokens * p["salida"]  # incluye los tokens de razonamiento
    return (entrada + escritura + lectura + salida) / 1_000_000

cliente = anthropic.Anthropic()
modelo = "claude-sonnet-5-5"

respuesta = cliente.messages.create(
    model=modelo,
    max_tokens=1024,
    messages=[{"role": "user", "content": "Resume en tres puntos qué es la API de Claude."}],
)

print(respuesta.content[0].text)
print(f"Coste de esta llamada: ${coste_usd(modelo, respuesta.usage):.5f}")

Algunas notas:

• Los tokens que se leen de la caché o se escriben en ella aparecen en campos separados de input_tokens. Por eso el script los suma aparte.
• Si quieres saber cuánta salida ha sido razonamiento, la API lo indica en usage.output_tokens_details.thinking_tokens.
• El script supone la caché de 5 minutos. Si usas la de 1 hora, cambia el multiplicador a 2.

Si todavía no tienes tu clave ni el SDK instalado, empieza por nuestra guía API de Anthropic: cómo obtener tu API key y empezar.

Cómo se paga y cómo evitar sustos en la factura

• Prepago con créditos. Según el centro de ayuda de Anthropic, la mayoría de cuentas compran créditos por adelantado en la consola (Settings → Billing, en platform.claude.com). Se pueden aplicar los impuestos que correspondan. Si se acaban los créditos, la API deja de responder hasta que recargas, así que no hay deudas por sorpresa.
• Recarga automática opcional. Puedes activar auto-reload para que compre créditos cuando el saldo baje de un mínimo. Si buscas control total, déjala desactivada al principio.
• Los créditos caducan al año de la compra y no se reembolsan. Compra poco al empezar.
• Límite de gasto mensual. Cada nivel de uso tiene un tope de gasto mensual, y en la consola puedes fijar tu propio límite. Si lo alcanzas, la API devuelve un error 429 y se pausa hasta las 00:00 UTC del día 1 del mes siguiente, salvo que subas el límite.
• Solo pagas las llamadas que salen bien. Las peticiones fallidas no se cobran. Ojo: si tu programa se desconecta a mitad de una petición que iba a completarse, esa sí se cobra.
• Todo se factura en dólares. Si pagas desde España, México, Colombia, Argentina u otro país, tu banco hace la conversión. Revisa qué comisión te aplica por pagos en moneda extranjera.

Preguntas frecuentes sobre el precio de la API de Claude