API de Claude: ¿existe nivel gratuito o créditos?

¿La API de Claude tiene un nivel gratuito?

La API de Claude no tiene un nivel gratuito. No existe una asignación mensual de tokens gratuitos ni un plan que pueda mantener por $0. Las cuentas nuevas reciben una pequeña cantidad de créditos gratuitos para probar la API, pero la documentación de precios de Anthropic no indica cuál es esa cantidad. Cuando se consumen esos créditos, las solicitudes utilizan crédito de pago u otras concesiones de crédito para la API. Si también paga una suscripción Max, Ultra o Team, esos planes incluyen un crédito mensual para la API, que se explica más adelante. Si investiga sobre seguridad o alineación de la IA, el programa External Researcher Access Program de Anthropic asigna $1,000 en créditos para la API a la cuenta de cada solicitante aprobado, a fecha de octubre de 2026. Anthropic revisa las solicitudes el primer lunes de cada mes y no responde a las solicitudes que rechaza.

Esa es la respuesta directa. El resto de esta guía explica sus consecuencias: qué partes de la plataforma no tienen ningún coste, por qué esta cuestión es distinta del plan gratuito de las aplicaciones de Claude y cuál es la forma más económica y realista de poner en funcionamiento el primer programa.

Qué es gratuito en una cuenta de la API de Claude

Varias partes de la plataforma no tienen coste por token, y son más importantes de lo que parece.

• Recuento de tokens. El endpoint de recuento de tokens es de uso gratuito. Tiene su propio límite de peticiones por minuto, independiente de la creación de mensajes, por lo que medir un prompt nunca consume el presupuesto destinado a enviarlo.
• La propia consola. Crear una organización, consultar la página de uso y abrir el playground (anteriormente conocido como Workbench) no tiene coste. Ejecutar un prompt en el playground es una petición de API normal, por lo que esa parte factura tokens como cualquier otra llamada.
• Operaciones con archivos. Subir, listar y eliminar archivos a través de la API de Files es gratuito. Solo se paga cuando el contenido de un archivo entra en una petición como tokens de entrada.
• Obtención de datos web (web fetch). La herramienta de obtención web no añade cargos más allá de los tokens de lo que extraiga hacia la conversación. La búsqueda web no es gratuita: cuesta $10 por cada 1,000 búsquedas a fecha de octubre de 2026.
• Ejecución de código, hasta cierto punto. Cada organización dispone de 1,550 horas de contenedor gratuitas al mes a fecha de octubre de 2026; después, el coste es de $0.05 por hora y contenedor. La ejecución de código no tiene coste adicional en una petición que incluya búsqueda web o obtención web en sus versiones 20260209 o posteriores.

Nada de esto constituye un nivel gratuito. Significa que la medición es transparente: se factura por la inferencia y no por la infraestructura subyacente. La obtención web gratuita funciona bien con fuentes de datos que también son gratuitas, y ejecutar análisis de acciones y opciones desde una API de datos de mercado sin clave es un ejemplo práctico donde lo único que se paga son los tokens que los datos obtenidos aportan al prompt.

Calcula el coste de una solicitud antes de pagarla

Como contar tokens es gratis, primero puedes conocer el tamaño de una solicitud. El recuento es una estimación, y la documentación de Anthropic indica que los tokens que usa una solicitud real pueden diferir ligeramente. Este es el mismo endpoint que utilizan los SDK y acepta el mismo cuerpo que un mensaje real, con algunas excepciones: rechaza las solicitudes que incluyen herramientas del servidor, como búsqueda web, obtención de contenido web o ejecución de código, el conector MCP, o imágenes y PDF enviados mediante una URL o un ID de archivo. Para contarlos, envía las imágenes y los PDF como base64.

En el ejemplo siguiente, usa una clave asignada a un espacio de trabajo. Si la clave no está asignada a un espacio de trabajo, envía también anthropic-workspace-id con el ID del espacio de trabajo. Si lo omites, la respuesta será HTTP 400 con invalid_request_error.

curl https://api.anthropic.com/v1/messages/count_tokens \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4-5",
    "system": "You are a scientist",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Una respuesta correcta es una línea de JSON, como {"input_tokens": 14}. Multiplica ese valor por la tarifa de entrada de tu modelo para obtener una estimación aproximada del coste de entrada de la solicitud antes de enviarla. Cuenta los tokens del modelo que realmente vas a utilizar, porque los modelos Claude 4.7 y posteriores generan aproximadamente un 30% más de tokens para el mismo texto que modelos anteriores, como Haiku 4.5. Si recibes HTTP 401 con authentication_error, comprueba si la clave es incorrecta, se ha revocado o ha caducado. Una clave proporcionada correctamente también devuelve este error cuando caduca. Comprueba su fecha de caducidad en la Console y crea una clave nueva, porque las claves caducadas no se pueden reactivar. Si la clave parece correcta y la llamada sigue sin autenticarse, o si accedes a Claude mediante Bedrock, Vertex o Foundry en lugar de mediante una clave de Anthropic, las cuatro formas de autenticar un cliente explican qué espera cada una y dónde se debe almacenar la credencial.

Por qué esta es una pregunta distinta del plan gratuito de las aplicaciones

La gente busca ambas cosas, pero casi no tienen relación entre sí. El plan gratuito de las aplicaciones de Claude es un producto real que se puede usar durante mucho tiempo sin tarjeta y cuyo consumo se mide mediante una ventana móvil de uso. Qué incluye realmente el nivel gratuito de Claude explica qué ofrece y cuándo se restablece. La API utiliza medición prepago y no tiene detrás un plan de ese tipo.

La consecuencia que más confunde es que, en la mayoría de los planes, una suscripción y una clave de API son monederos independientes. Pagar Pro no financia una clave, y los créditos de API no aumentan el límite de uso del chat. Claude Code es donde esta separación causa más confusión, porque funciona con cualquiera de las dos opciones: Si Claude Code está incluido con Pro indica qué planes lo cubren y cuándo cambia silenciosamente a la facturación de una clave. Si está eligiendo entre ambas opciones en lugar de intentar evitar cualquier pago, Coste de Claude API frente a una suscripción desarrolla los cálculos con cargas de trabajo reales.

Hay dos excepciones. Desde el 7 de octubre de 2026, los planes Max y Team incluyen un crédito mensual de API. En octubre de 2026, es de $100 en Max y de $200 en Ultra, anteriormente Max 20x. En Team, es de $20 por puesto Standard o de $100 por puesto Premium, se comparte entre los puestos y está limitado a $500. Para reclamarlo, debe vincular una organización de Console. Los nuevos suscriptores deben esperar primero 7 días. No es necesario añadir un método de pago a Claude Platform. El crédito cubre la API, Agent SDK y Managed Agents, pero no Claude Code interactivo. También cubre claude -p cuando lo ejecuta usted mismo con una clave de API de la organización de Console vinculada. Las ejecuciones iniciadas por Claude Code GitHub Action, una extensión de IDE o la aplicación de escritorio de Claude no están cubiertas. El crédito no utilizado caduca al final de cada ciclo de facturación. Cuando se agota, las solicitudes se detienen hasta que llegue el siguiente crédito, salvo que también haya comprado crédito de API o tenga un acuerdo de facturación. Los planes Free, Pro y Enterprise no lo reciben. Por eso, consulte Qué debe valorar antes de cambiar a Max antes de comprar un plan principalmente por el crédito. La otra excepción es Claude Enterprise, que combina un precio por puesto con el consumo de tokens medido según las tarifas estándar de la API. Cómo funciona el precio por puesto de Enterprise explica qué cubre el mínimo de puestos antes de que comience la medición.

Cuánto cuesta una petición una vez agotados los créditos

Estas son las tarifas de la API de primera parte a fecha de octubre de 2026, por millón de tokens.

[
  {
    "label": "Haiku 4.5",
    "input_usd": 1,
    "output_usd": 5
  },
  {
    "label": "Sonnet 5",
    "input_usd": 2,
    "output_usd": 10
  },
  {
    "label": "Opus 5",
    "input_usd": 5,
    "output_usd": 25
  }
]

Haiku 4.5 factura 1 dólar por millón de tokens de entrada y 5 dólares por millón de tokens de salida. Opus 5 factura 5 y 25 por los mismos volúmenes, por lo que el modelo que elija modifica la factura en 5x antes de cualquier ajuste de prompt. Sonnet 5 se lanzó a 2 y 10 dólares como tarifa de introducción, y Anthropic ha mantenido ese precio como estándar, por lo que el aumento a 3 y 15 dólares programado para el 1 de septiembre de 2026 no se produjo. La salida cuesta cinco veces más que la entrada en todos ellos, lo cual es el dato más útil de esta página: una respuesta extensa es más cara que una pregunta larga. qué modelo de Claude debería usar los compara en un trabajo real. Fable 5 se sitúa por encima de los tres anteriores con 10 dólares por millón de tokens de entrada y 50 dólares por millón de salida, por lo que vale la pena aclarar qué ofrecen realmente esas tarifas antes de dirigir cualquier tarea rutinaria hacia él. También hay tres modelos más recientes en la lista de precios: Haiku 5.5 factura 0,10 dólares por millón de tokens de entrada y 0,50 dólares por millón de salida para prompts de hasta 100.000 tokens, Sonnet 5.5 factura 2 y 10 dólares, y Opus 5.5 factura 4 y 20 dólares.

Las rutas reales más económicas para experimentar

Cuatro palancas realizan casi todo el trabajo y ninguna requiere un descuento.

• Comience con el modelo más pequeño que supere su prueba. La clasificación, extracción, etiquetado y enrutamiento rara vez necesitan un modelo de frontera. Haiku 4.5 cuesta una quinta parte que Opus 5 y responde más rápido.
• Establezca un límite max_tokens. Es un techo estricto para los tokens generados, y la salida es la mitad costosa. Un clasificador que responde con una sola palabra no debería tener un presupuesto de 16,000 tokens.
• Almacene en caché la parte del prompt que nunca cambia. Una lectura de caché cuesta el 10% del precio base de entrada en la mayoría de los modelos (5% en Opus 5.5 y Sonnet 5.5, y 2.5% en Fable 5.1) y una escritura de caché de cinco minutos cuesta 1.25x, por lo que la caché se amortiza después de una sola lectura. El almacenamiento en caché es una coincidencia de prefijo, lo que significa que el texto estable debe ir primero y la pregunta variable al final, o nada coincidirá y pagará la prima de escritura sin obtener beneficio.
• Procese por lotes todo lo que no sea interactivo. La Message Batches API tiene un 50% de descuento tanto en entrada como en salida, y la mayoría de los lotes terminan en menos de una hora. Los trabajos nocturnos, las actualizaciones de datos y las ejecuciones de evaluación deben realizarse ahí.

Un cálculo de costes para una primera aplicación pequeña

Tomemos un script de resumen de registros: 1,000 llamadas, cada una con unos 800 tokens de entrada correspondientes a líneas de registro y con unos 200 tokens de salida de resumen. Son 800,000 tokens de entrada y 200,000 tokens de salida en Haiku 4.5.

[
  {
    "label": "Standard rates",
    "cost_usd": "1.80"
  },
  {
    "label": "Same job on the Batch API",
    "cost_usd": "0.90"
  }
]

El cálculo es de 0.8 millones de tokens de entrada a $1 más 0.2 millones de tokens de salida a $5, lo que da un total de 1.80 dólares. Si se envía como lote, el mismo trabajo cuesta 0.90. Un saldo de crédito inicial cubre muchas pruebas a esa escala, por lo que la ausencia de un nivel gratuito se nota mucho más tarde de lo que suele esperarse. Para consultar el tutorial completo en un servidor propio, crear una primera aplicación de Claude API en un VPS explica la gestión de claves, el streaming y las rutas de error.

Los niveles de uso son límites máximos, no asignaciones

La API asigna automáticamente a cada organización un nivel de uso basado en su historial y en el estado de la cuenta. Los niveles se denominan Start, Build, Scale y Custom; cada uno establece límites de tasa y un tope de gasto mensual. A fecha de octubre de 2026, los topes son de $500 en Start, $1,000 en Build y $200,000 en Scale, mientras que Custom no tiene tope. Las organizaciones nuevas, o aquellas con poco historial de uso, pueden comenzar en un nivel Evaluation con límites inferiores hasta que se genere dicho historial.

Considere esto como un límite y no como una concesión. Estar en el nivel Start no significa que disponga de $500 para gastar. Significa que no puede gastar más de $500 en un mes natural antes de que el uso se detenga hasta el mes siguiente. También puede establecer su propio límite de gasto inferior al tope del nivel, lo cual es lo primero que debe hacer en cualquier cuenta vinculada a una tarjeta, ya que un bucle descontrolado es una forma mucho más común de perder dinero que el precio por token.

Qué hacer si el uso gratuito es un requisito estricto

Si el presupuesto es estrictamente cero y debe mantenerse así, la API no es la herramienta adecuada, y comparar niveles de servicio no cambiará esa realidad. Quedan dos opciones honestas. Utilice el plan gratuito en las aplicaciones de Claude para trabajo interactivo, aceptando que está limitado por ventana de uso y que no ofrece un endpoint programable. O bien, ejecute un modelo de pesos abiertos en hardware alquilado, lo que sustituye una factura por token por una factura de servidor que usted controla: ejecutar Ollama en un VPS para autoalojar un LLM detalla la memoria que requiere cada tamaño de modelo y las capacidades reales de los modelos pequeños. Si resulta que la ventana de uso es la restricción real y no el dinero, Claude Pro por 20 dólares al mes eleva ese límite en las aplicaciones por un coste inferior al de muchas facturas iniciales de API. Sin embargo, no incluye clave de API ni crédito de API. Lo más parecido a llamar a Claude desde código es Claude Code, que está incluido en Pro y puede ejecutarse de forma no interactiva con claude -p sujeto a los mismos límites de uso. Si merece la pena pagar esos 20 dólares depende de la frecuencia con la que el límite gratuito le detenga, algo que una guía de decisión para Pro analiza según patrones de uso reales. Si está comparando proveedores en lugar de una única oferta, planes de Claude y ChatGPT comparados por precio presenta los niveles gratuitos y de pago de ambos, incluyendo cuál resulta más económico para tareas de programación. Y si una suscripción que ya está pagando forma parte del gasto que intenta eliminar, cancelar o reducir ese plan mantiene el mes que ya ha pagado y detiene el siguiente.

Para cualquier caso intermedio, la respuesta práctica es una clave con fondos, un límite de gasto bajo, un modelo pequeño y el almacenamiento en caché de prompts activado desde el primer día.

FAQ

¿La API de Claude es gratuita?

No. No hay un nivel gratuito ni una asignación mensual de tokens gratuitos. Las cuentas nuevas reciben una pequeña cantidad de créditos gratuitos para probar la API. Después, las solicitudes consumen crédito de pago u otras asignaciones de crédito para la API. Entre ellas se incluye el crédito mensual para la API de los planes Max, Ultra y Team, que no requiere un método de pago en Claude Platform, y los $1,000 en créditos para la API que el External Researcher Access Program de Anthropic aplica a las cuentas de investigadores aprobados en seguridad y alineación de IA. Algunas funciones de la plataforma no tienen coste, como el recuento de tokens, la carga y eliminación de archivos y la herramienta de obtención web, salvo los tokens del contenido que obtiene.

¿Recibo créditos gratuitos al registrarme en la API de Claude?

Sí, una pequeña cantidad, aunque la documentación de precios de Anthropic no indica la cifra. Considérela suficiente para comprobar que la integración funciona, no como un presupuesto sobre el que basar el desarrollo. El crédito de prueba ampliado para la evaluación empresarial se gestiona a través del equipo comercial de Anthropic; no se concede automáticamente.

¿La suscripción a Claude Pro o Max incluye acceso a la API?

Pro no lo incluye y Max ahora incluye una parte. Una suscripción Pro y una clave de API se facturan por separado y se miden de forma distinta: Pro amplía su cuota dentro de las aplicaciones de Claude y Claude Code, y nada más. En octubre de 2026, Max incluye un crédito mensual para la API de $100 y Ultra incluye $200. Para reclamarlo, debe vincular una organización de Console. Cubre las llamadas a la API, pero no el uso interactivo de Claude Code, caduca en cada ciclo de facturación y no cambia sus límites en las aplicaciones. Una vez agotado ese crédito, una clave de API consume créditos prepagados y queda limitada por minuto según el número de solicitudes y de tokens.

¿Cuál es la forma más barata de probar la API de Claude?

Cuente primero los tokens, porque ese endpoint es gratuito. Después, ejecute la prueba con Haiku 4.5 y un max_tokens ajustado, almacene en caché un prefijo de prompt fijo de al menos 4,096 tokens para que las llamadas repetidas lean al 10% del precio de entrada y envíe mediante Batch API todo lo que no sea interactivo, a mitad de precio. Con esos ajustes, mil llamadas pequeñas cuestan menos de un dólar en octubre de 2026.