Cómo calcular el uso de tokens de una API en 2026: cuánto durará tu presupuesto

Ingresas dinero en una cuenta de API y casi de inmediato surge la pregunta: ¿cuánto durará? Tienes algo así como «Tengo diez mil, la entrada cuesta tanto, la salida cuesta más y también hay algún tipo de descuento de caché» en la cabeza, pero no sabes muy bien cómo convertir todo eso en una sola cifra. Voy a explicarlo paso a paso y con números.

La idea principal por adelantado: una factura de API se calcula con una fórmula: número de tokens multiplicado por el precio por token. Los tokens de entrada y de salida se cuentan por separado porque tienen precios distintos. A continuación, te mostraré cómo calcular cuánto durará tu presupuesto y cómo se incluye la caché en el cálculo.

Encontrarás información sobre el uso de Ailoot en la documentación.

¿De qué se compone una factura de API?#

Cuando llamas a un modelo a través de una API, pagas por la cantidad de texto que pasó por el modelo. Esa cantidad se mide en tokens. Un token es un pequeño fragmento de texto; volveré a hablar de él en la siguiente sección, pero por ahora, piensa en él como la unidad en la que se mide todo.

Una llamada tiene dos partes. La primera es lo que enviaste al modelo: la pregunta en sí, los fragmentos de código o el documento adjuntos, los mensajes anteriores de la conversación y la instrucción del sistema al principio. Esto es la entrada. La segunda es lo que escribió el modelo como respuesta. Esto es la salida. DeepSeek lo dice directamente en su descripción de precios: la factura se basa en el número total de tokens de entrada y de salida.

La entrada y la salida tienen precios distintos, por eso se cuentan por separado. La fórmula para una solicitud es sencilla:

cost = (input tokens × input price) + (output tokens × output price)

Los precios suelen indicarse por millón de tokens; es más práctico porque un solo token cuesta una fracción de una unidad monetaria. Todos los cálculos a partir de aquí se basan en esta fórmula, y tu presupuesto alcanza exactamente para tantas solicitudes como puedas pagar con los fondos disponibles a ese precio.

Un token no es una palabra: ¿cómo puedes estimar cuántos vas a usar?#

Lo primero con lo que todo el mundo tropieza: un token no es lo mismo que una palabra. El modelo divide el texto en fragmentos según sus propias reglas, y un fragmento puede ser una palabra corta completa, parte de una palabra más larga, un espacio junto con una letra o un signo de puntuación. Así que no puedes calcular exactamente de cabeza «cuántos tokens necesitará mi solicitud»; solo puedes estimarlo.

Aquí tienes una referencia aproximada. En el texto en inglés, un token corresponde a unos cuatro caracteres; ese es un punto de partida que dan la propia Anthropic y OpenAI. Los modelos dividen el texto en ruso en fragmentos más pequeños: el alfabeto cirílico se separa en partes más cortas, por lo que un texto con el mismo significado utiliza más tokens. Cuántos más depende del modelo, pero deberías prever entre una vez y media y dos veces más que en inglés.

Así se traduce eso en tokens. Si envías al modelo una página de texto y recibes un párrafo como respuesta, ya son miles de tokens de entrada y cientos de tokens de salida. Y si adjuntas un archivo grande a una solicitud o mantienes un historial de conversación extenso, la entrada puede crecer hasta decenas de miles de tokens, que supondrán la mayor parte de la factura. La respuesta de la API muestra la cifra exacta: en sus campos de metadatos indica cuántos tokens se usaron realmente para la entrada y la salida. Pero para estimar tu presupuesto de antemano, basta con un cálculo aproximado basado en el número de caracteres.

¿Por qué cuesta más la salida que la entrada y cómo afecta eso a tu factura?#

Aquí tienes una tabla con los precios oficiales por millón de tokens a principios de septiembre de 2026. Puedes ver que la salida cuesta varias veces más que la entrada en todos los casos.

La diferencia de precios entre proveedores es enorme: un millón de tokens de entrada para Claude Opus 5 cuesta lo mismo que unos 7,58 millones para DeepSeek Pro según las tarifas de entrada de la tabla (5 $ ÷ 0,66 $ ≈ 7,58). Pero dentro de cada nivel de precios se cumple una regla: la salida cuesta entre tres y seis veces más que la entrada. La razón es sencilla: al modelo le resulta más fácil leer tu solicitud que escribir una respuesta, y el trabajo más exigente cuesta más.

De ahí se desprende una conclusión que afecta directamente a tu factura. Una respuesta larga es más cara que una pregunta larga. Si le pides al modelo que «lo explique con todo lujo de detalles», tú mismo estás aumentando la parte más cara de la factura. El mismo significado expresado en una respuesta breve cuesta varias veces menos. Esta es una de las razones por las que el vibe coding le sale barato a una persona, pero le consume el presupuesto a otra en un día, incluso con el mismo modelo.

¿Cómo calcular cuánto durará un presupuesto de API?#

Hagamos el cálculo paso a paso. Introduce tus propios precios, el volumen habitual de tokens y tu presupuesto.

1. Estima una solicitud típica. Supongamos que una llamada utiliza 20.000 tokens de entrada (la pregunta más un fragmento de código y algo de historial) y 2.000 tokens de salida (la respuesta del modelo).
2. Calcula el coste de entrada: divide el número de tokens de entrada entre un millón y multiplícalo por tu precio de entrada por millón de tokens.
3. Calcula el coste de salida: divide el número de tokens de salida entre un millón y multiplícalo por tu precio de salida por millón de tokens.
4. Suma los costes de entrada y salida.
5. Divide tu presupuesto por el coste por solicitud obtenido.

Con las tarifas de Opus 5 de la tabla: 20.000 ÷ 1.000.000 × 5 $ = 0,10 $ de entrada, y 2.000 ÷ 1.000.000 × 25 $ = 0,05 $ de salida. Total: 0,15 $ por solicitud sin caché. Un presupuesto de 10 $ cubre 66 solicitudes completas (9,90 $), suponiendo esos mismos tokens y ningún otro cargo.

Una solicitud real casi nunca es «promedio»: adjunta un archivo grande o alarga una conversación y la entrada crecerá de 20.000 a 200.000 tokens. Así que calcula según tu forma habitual de trabajar; una solicitud idealizada te dará un resultado equivocado. También es mejor redondear hacia arriba.

Devin, Claude Code y cualquier otro agente de IA utilizan la misma API y consumen tokens según la misma fórmula. La única diferencia es que un agente utiliza más porque hace muchas llamadas en segundo plano. En el artículo sobre el coste oculto del vibe coding expliqué por separado por qué esto hace que el vibe coding cueste más de lo esperado.

¿Qué es el descuento de caché y cuándo se aplica?#

Ahora, la caché, ese «descuento de hasta el 80 %» que hace que el cálculo parezca complicado. El funcionamiento es sencillo. Una parte de la entrada permanece igual de una solicitud a otra: la instrucción del sistema al principio, un contexto extenso o un documento adjunto con el que trabajas durante varias llamadas. La caché permite que el modelo no tenga que volver a leer esa parte desde cero cada vez y la recupere de la memoria a un precio mucho menor.

Cuánto más bajo depende del proveedor. En Claude, volver a leer desde la caché cuesta diez veces menos que la entrada normal: para Opus 5, la entrada normal cuesta 5 $ por millón, mientras que una lectura de caché cuesta 0,50 $. El descuento de DeepSeek es aún mayor: la entrada almacenada en caché para el modelo flash cuesta 0,007 $ frente a 0,22 $ de la entrada normal, más de treinta veces menos. Por tanto, «hasta un 80 % de descuento» es una estimación moderada; el descuento real puede ser mayor.

Ten presentes dos condiciones para que el cálculo de la caché no te salga mal.

• El descuento solo se aplica a la entrada que se repite. El modelo genera la salida desde cero cada vez, sin ningún descuento de caché. Si la mayor parte de tu factura corresponde a respuestas largas, la caché te ahorrará muy poco.
• La primera escritura en la caché cuesta un poco más que la entrada normal. Para el almacenamiento a corto plazo, Claude cobra 1,25 veces el precio de entrada normal por una escritura en la caché. El ahorro empieza con la segunda solicitud, que lee la parte ya almacenada en la caché. La caché no ayuda en una solicitud de una sola vez e incluso cuesta un poco más.

¿Cómo puedes recalcular tu presupuesto teniendo en cuenta la caché?#

Volvamos al volumen de solicitudes del ejemplo y añadamos la caché. La idea es dividir la entrada en dos partes: la parte que se repite y cumple los requisitos para recibir el descuento, y la parte nueva en cada solicitud.

Tomemos la misma solicitud con 20.000 tokens de entrada y 2.000 de salida: 15.000 de entrada son contexto estable y 5.000 son nuevos. Utilizamos las tarifas de Opus 5 anteriores: 5 $ por millón de entrada nueva, 0,50 $ por millón de lectura de caché, 6,25 $ por millón de escritura de caché de corta duración (1,25 × 5 $) y 25 $ por millón de salida.

La solicitud repetida es un 45 % más barata que los 0,15 $ sin caché, aunque su porción de entrada en caché cueste un 90 % menos. La primera escritura cuesta más. Dos llamadas (una escritura y un acierto) cuestan 0,25125 $, frente a 0,30 $. Con 10 $, una escritura seguida de 119 aciertos verificados permite 120 llamadas por 9,98625 $. Se supone que la caché conserva su validez, todas las llamadas tienen esos tokens y no hay otros cargos; utiliza el uso real de lectura y escritura en caché en vez de dar por hecho que cada repetición acierta.

La regla es esta: la caché resulta útil cuando utilizas un contexto extenso en muchas solicitudes e inútil para preguntas breves y aisladas.

¿Dónde se consumen tokens sin que te des cuenta?#

Las facturas suelen acabar siendo más altas de lo estimado, casi siempre por tres motivos que no se ven de un vistazo.

El primero y más importante es el historial de conversación. El modelo no recuerda por sí solo los mensajes anteriores; cada vez se le vuelve a enviar toda la conversación como parte de la entrada. Esto significa que el décimo mensaje de una conversación larga incluye los nueve mensajes anteriores y sus respuestas. Una solicitud cuesta poco al principio de una conversación, pero hacia el final una pregunta con el mismo significado cuesta varias veces más porque la entrada ha crecido. Aquí tienes un truco sencillo: cuando cambie el tema, inicia una conversación nueva. No hace falta alargar una conversación para siempre.

El segundo motivo es el modo de razonamiento. Los modelos más recientes tienen un modo en el que el modelo desarrolla primero su razonamiento internamente y solo después responde. Ese razonamiento también cuenta como tokens de salida, y la salida es la parte más cara. La respuesta parece breve, pero hay muchos tokens detrás, así que la factura sorprende.

El tercero son los archivos adjuntos grandes. Si adjuntas un documento extenso o un lote de archivos a una solicitud, se envían completos como entrada en cada llamada mientras permanezcan en el contexto. Si trabajas con el mismo documento durante un tiempo, conviene mantenerlo en caché para no seguir pagando el precio completo. Gestionar lo que permanece en el contexto es una habilidad aparte, llamada ingeniería de contexto, que afecta directamente a tu factura.

¿Cómo puedes controlar tus gastos sin hacer los cálculos manualmente?#

Solo necesitas hacer una estimación manual una vez, para entender en general cuánto durará tu dinero. Después ya no hace falta calcularlo a mano; la API lo hace por ti.

Cada respuesta del modelo incluye campos de metadatos con el número exacto de tokens de la solicitud: cuántos se usaron como entrada, cuántos como salida, cuántos tokens de entrada se leyeron desde la caché y cuántos se escribieron en ella por primera vez. Son datos exactos de una llamada concreta y muestran adónde va realmente tu presupuesto. Si utilizas una herramienta como Claude Code, normalmente muestra el uso después de cada tarea.

El panel del proveedor también tiene una página de uso, con los gastos por día y tu saldo actual. Consúltala de vez en cuando, sobre todo durante las primeras semanas, hasta que te familiarices con tu patrón de gasto habitual. Un par de hábitos también te ayudarán a ahorrar: establece un límite de gasto mensual si tu proveedor lo permite y no actives las recargas automáticas de saldo hasta que sepas cuánto sueles gastar. De lo contrario, un agente que se descontrole durante la noche podría cobrarte más de lo esperado.

Descubre Ailoot.