Cómo se cuentan los tokens

Cómo se cuentan y facturan los tokens de entrada y salida, cómo funciona el descuento por caché y cómo estimar el costo de una solicitud antes de enviarla.

Los tokens son la unidad con la que Claude (y cualquier otro LLM) mide el trabajo. Aproximadamente 4 caracteres de texto en inglés, y más o menos lo que pagas.

Todos los modelos, capacidades y precios Índice de la documentación para agentes de IA: https://oneprovider.dev/docs/llms.txt

Regla práctica

1 token ≈ 4 caracteres en inglés ≈ 0,75 palabras.
Una página de prosa (~500 palabras) son ~670 tokens.
El código fuente, las escrituras no latinas y los emojis se tokenizan de forma más densa: calcula entre 1,2 y 2 veces la tasa del inglés.
Una ventana de contexto de 200k tokens equivale a unas 150k palabras en inglés, alrededor de 300 páginas.

Cuatro tipos de tokens en tu factura

Datos de referencia

Tipo	Qué es	Cómo se factura
Input	Cada token que el modelo lee: prompt del sistema, turnos anteriores, mensaje actual del usuario, esquema de herramientas, imágenes.	Tarifa completa de entrada.
Output	Cada token que el modelo escribe: texto de la respuesta, llamadas a herramientas, razonamiento (si está activado).	Tarifa completa de salida (normalmente 5 veces la de entrada).
Cache read	Tokens de entrada servidos desde el punto de caché de una solicitud anterior.	El 10 % de la tarifa de entrada en la mayoría de los modelos; las tarifas exactas de cada modelo están en la tabla de modelos .
Cache write	La primera solicitud en un punto de caché: crea la caché para lecturas posteriores.	El 125 % de la tarifa de entrada en la mayoría de los modelos; las tarifas exactas de cada modelo están en la tabla de modelos .

Cada respuesta incluye estos recuentos en el campo usage; consulta Consumo y facturación .

Estimar antes de enviar

Los SDK de Anthropic incluyen una función para contar tokens que puedes ejecutar en local:

python

from anthropic import Anthropic
client = Anthropic(base_url="https://api.oneprovider.dev")
count = client.messages.count_tokens(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": "Your long prompt here"}],
)
print(count.input_tokens)

El recuento es un mínimo: no incluye la salida que el modelo está a punto de escribir. Para presupuestar, añade un tope de max_tokens y supón el peor caso.

Cómo estimar el ahorro con la caché

No existe un multiplicador universal entre modelos. Para el modelo equilibrado actual claude-sonnet-5-5 o cualquier otro, usa sus valores separados de Lectura de caché y Escritura de caché de la tabla de tarifas generada. Compáralos con la tarifa de entrada del modelo elegido y el número esperado de lecturas repetidas.

Una solicitud, con su precio En la parte superior de /pricing se calcula el precio de una solicitud de ejemplo línea por línea: entrada, lectura de caché y salida a la tarifa de cada modelo; son los mismos números de la tabla de tarifas .

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .

Última actualización: 2026-11-08 ¿Encontraste un error? @Oneproviderhelpbot