La fórmula
Cualquier calculadora de costes de la API de Claude, ya sea una página web o una hoja de cálculo, hace lo mismo:
costo = (tokens de entrada / 1,000,000) × tasa de entrada + (tokens de salida / 1,000,000) × tasa de salida
Las tarifas son la parte que debes buscar. Para Claude, lee la página de precios actual de Anthropic, porque las tarifas difieren según el modelo y cambian con el tiempo, y funciones como el caché pueden alterar la factura. No las cito aquí. Para este endpoint las tarifas son fijas: $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. El crédito es prepago, no caduca, y las peticiones fallidas o rechazadas no se cobran.
Paso 1: estima tus tokens
Necesitas cuatro números por tarea: peticiones al mes, tokens de entrada promedio, tokens de salida promedio y un factor de reintento. Algunas reglas prácticas ayudan cuando aún no tienes registros. El texto en inglés tiene alrededor de 4 caracteres por token, por lo que una página de 500 palabras son aproximadamente 650 a 750 tokens. Los prompts del sistema y el historial de chat cuentan como entrada en cada llamada. Para la salida, usa la longitud que solicitas más aproximadamente un 10%.
Una vez que tengas tráfico, deja de adivinar. Cada respuesta incluye un bloque usage con tokens de prompt y de completado, y esta API también devuelve el encabezado X-Balance-USD después de cada llamada, para que puedas vigilar el gasto en vivo.
Paso 2: tres ejemplos resueltos en este endpoint
Bot de soporte de borradores
20.000 conversaciones al mes, 1.200 tokens de entrada y 300 de salida cada una.
- Entrada: 20.000 x 1.200 = 24M tokens, 24 x $0,15 = $3,60
- Salida: 20.000 x 300 = 6M tokens, 6 x $0,50 = $3,00
- Total mensual: $6,60
Resúmenes de documentos
3,000 documentos al mes, 20,000 tokens de entrada y 800 tokens de salida cada uno.
- Entrada: 60M tokens x $0,15 = $9,00
- Salida: 2,4M tokens x $0,50 = $1,20
- Total mensual: $10,20
Aplicación de chat de ficción
100.000 turnos al mes, 3.000 tokens de entrada y 300 de salida cada uno.
- Entrada: 300M tokens x $0,15 = $45
- Salida: 30M tokens x $0,50 = $15
- Total mensual: $60
Para comparar con Claude, introduce sus tarifas actuales en las mismas líneas para los mismos recuentos de tokens. La diferencia entre los dos totales es tu ahorro, o tu prima por un modelo más potente. Ambos son resultados legítimos. Este endpoint sirve un único modelo de pesos abiertos, uncensored, ejecutado por un proveedor independiente. No es Claude ni un producto de Anthropic, por lo que la pregunta correcta es si su calidad es suficiente para tu tarea.
Paso 3: un script que hace las matemáticas con el uso real
Este script de Python envía una petición e imprime el coste exacto a partir de los números de usage devueltos. Cambia las tarifas para comparar cualquier proveedor.
from openai import OpenAI
RATE_IN, RATE_OUT = 0.15, 0.50 # dollars per 1M tokens, this endpoint
client = OpenAI(base_url="https://api.claudeapicost.com/v1", api_key="YOUR_KEY")
def cost(usage, rate_in=RATE_IN, rate_out=RATE_OUT):
return usage.prompt_tokens / 1e6 * rate_in + usage.completion_tokens / 1e6 * rate_out
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain tokens in two sentences."}],
)
print(r.usage.prompt_tokens, r.usage.completion_tokens)
print(f"this call: ${cost(r.usage):.6f}")
# What the same call would cost at other rates, e.g. numbers from another pricing page:
# print(cost(r.usage, rate_in=YOUR_IN, rate_out=YOUR_OUT))
Para una previsión mensual, multiplica el coste promedio por llamada por tu recuento de peticiones. Añade un margen de seguridad del 20 al 30% para el crecimiento y conversaciones más largas.
Comprobando el saldo desde la shell
Para ver el gasto sin código, lee el saldo antes y después de un lote. El encabezado X-Balance-USD está en cada respuesta, y GET /v1/balance lo devuelve por sí solo.
curl -s https://api.claudeapicost.com/v1/balance \
-H "Authorization: Bearer YOUR_KEY"
curl -si https://api.claudeapicost.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":50,"messages":[{"role":"user","content":"Hi"}]}' | grep -i x-balance
La diferencia entre dos lecturas, dividida por el número de llamadas, es tu coste real por llamada.
Lo que las hojas de cálculo olvidan
- Tokens de salida. Cuestan más por token que la entrada aquí ($0,50 frente a $0,15), y los prompts con razonamiento producen respuestas largas.
- Historial. Un chat reenvía los turnos anteriores en cada llamada, por lo que la entrada crece con la longitud de la conversación.
- Reintentos. Las llamadas fallidas son gratuitas aquí pero aún te cuestan tiempo; las denegaciones en otros lugares pueden multiplicar el número real de llamadas.
- Picos. Los límites de velocidad importan: una clave completa permite 8 peticiones concurrentes y 300 por minuto.
- Recarga mínima. El crédito se compra en cantidades enteras desde $20 hasta $500, así que planifica tu primera recarga.
El artículo mitos versus hechos de los precios analiza estas trampas con más detalle.
Recargar y probar primero
Las recargas van desde $20 hasta $500, cualquier cantidad entera, con +5% desde $50, +10% desde $100 y +15% desde $200. Paga con cripto (USDT en TRC20, USDC en Base). Consulta la página de precios para la tabla completa.
Para probar tu estimación con prompts reales, reclama el crédito de prueba de $0,50 en la página de claves. Dura 7 días, no requiere tarjeta y es por persona. La documentación enumera los campos de uso y los códigos de error. Si recibes un 429, superaste un límite de peticiones o concurrencia, así que reduce la velocidad o reintenta después del valor Retry-After.

