Costos y consumo

Theus estima el costo y el consumo de tokens de tu sesión de forma local, a partir del uso real de cada modelo. Sin proveedor remoto obligatorio: cuando trabajas con tu propia clave (BYOK) o con un modelo local, el costo real lo define tu proveedor.

El comando /cost

Escribe /cost en la sesión para ver un resumen del costo total y la duración acumulada. El comando muestra el costo total y la duración de la sesión actual y también funciona en modo no interactivo.

El resumen incluye estos campos:

• Total cost — costo estimado acumulado en USD.
• Total duration (API) — tiempo total consumido en llamadas al proveedor.
• Total duration (wall) — tiempo total transcurrido de la sesión.
• Total code changes — líneas añadidas y eliminadas por las herramientas.
• Usage by model — desglose por modelo: tokens de entrada, de salida, de lectura de caché, de escritura de caché y, si aplica, búsquedas web, con el costo parcial de cada modelo.

Cómo se calcula el consumo

Cada respuesta del modelo reporta su uso de tokens. Theus toma esos valores y los multiplica por la tarifa del modelo para obtener un costo en USD, acumulándolo en el estado de la sesión. El cálculo cubre cinco componentes:

• Tokens de entrada (input).
• Tokens de salida (output).
• Tokens de lectura de caché de prompt (cache read), mucho más baratos que la entrada normal.
• Tokens de escritura de caché de prompt (cache write).
• Búsquedas web, tarifadas por solicitud.

Las tarifas se expresan por millón de tokens (Mtok). A modo de referencia, Theus mantiene varios niveles de precio internos, por ejemplo:

Las búsquedas web se tarifan a $0.01 por solicitud. Algunos modelos tienen una tarifa distinta bajo modo rápido.

Modelos desconocidos y estimaciones

Theus solo conoce las tarifas de sus propios modelos de primera parte. Si usas un modelo cuyo precio no está registrado, Theus lo estima aplicando una tarifa por defecto y marca el resumen con una advertencia:

Total cost:            $0.1234 (costs may be inaccurate due to usage of unknown models)

Modelo local-first: el costo depende del proveedor

Theus es local-first: ningún servicio remoto es obligatorio para arrancar. Esto tiene consecuencias directas sobre el costo:

• Modelo local — si ejecutas el modelo en tu propia máquina o infraestructura, no hay cargo por token: el "costo" es tu propio cómputo. La estimación de /cost puede seguir apareciendo, pero no representa un gasto facturable.
• BYOK (tu propia clave) — al conectar tu clave a un proveedor compatible, el consumo y la tarifa reales los define ese proveedor, según su propia política de precios. La estimación de Theus solo coincidirá con tu factura si el modelo y sus tarifas coinciden con los niveles conocidos.
• Suscripción Theus — el uso se cubre con tu plan; /cost lo refleja como cobertura de suscripción en lugar de gasto por token.

La selección de proveedor sigue el orden documentado (variables THEUS_BASE_URL / THEUS_OPENAI_BASE_URL, luego el primer proveedor con capacidad de texto en ~/.theus/providers.json, y por último el motor compatible). El costo depende de cuál de estos atiende tus solicitudes.

Persistencia y resumen de sesión

El costo acumulado se guarda junto con la configuración del proyecto y se asocia a la sesión actual. Al reanudar la misma sesión, Theus restaura el costo, la duración y el uso por modelo, de modo que el total sigue creciendo desde donde lo dejaste en lugar de reiniciarse.

Cuando la sesión termina, si tu cuenta tiene acceso a facturación en consola, Theus imprime automáticamente el mismo resumen de /cost al salir, para que quede un registro del consumo de la sesión.