Créditos

Cómo funcionan el saldo de crédito, el pago y el consumo de crédito.

Los créditos son cuotas utilizadas por las operaciones API, MCP y CLI. Permiten el uso del medidor Epismo sin cambiar el modelo de datos de paquete y seguimiento.

Un crédito tiene el precio de $0.01. El pago requiere una compra mínima de 500 créditos.

Gratis es personal: la asignación de crédito mensual incluida y los créditos comprados pertenecen al usuario.
Las suscripciones a Workspace incluyen una asignación de crédito mensual compartida por todos los miembros, independientemente del número de miembros.
El uso se carga al grupo de espacios de trabajo activo y se conserva al usuario que realizó la acción para la atribución.

Saldo

El saldo acreedor se resuelve en el contexto personal o laboral actual. En API, utilice workspaceId al comprobar el equilibrio del espacio de trabajo. En CLI, el espacio de trabajo seleccionado o EPISMO_TOKEN determina el contexto.

epismo credit balance

El API devuelve:

{
	"balance": 1200,
	"shortfall": 0
}

shortfall es distinto de cero cuando el uso excedió los créditos disponibles en el contexto seleccionado.

Pagar

El proceso de pago inicia un flujo de compra y devuelve una URL.

epismo credit checkout --quantity 500

Carga útil API:

{ "quantity": 500 }

En el contexto de un espacio de trabajo Pro, los créditos comprados se agregan directamente al saldo de créditos del espacio de trabajo. En el espacio Libre personal, se agregan al saldo del usuario autenticado. El pago del espacio de trabajo está limitado al propietario del espacio de trabajo. quantity debe ser un número entero positivo de al menos 500.

¿Qué consume créditos?

Los créditos se consumen principalmente mediante llamadas API y MCP. Los comandos CLI siguen el mismo modelo de uso.

Nivel	Costo	Incluye
`pack.create`	5 créditos	Creando flujos de trabajo o contextos
`pack.search`	5 créditos	Búsqueda de flujos de trabajo o contextos
`suggestion.create`	5 créditos	Creación de sugerencias (máximo 20 por cuenta por día)
`alias.upsert`	5 créditos	Crear o redireccionar un alias
`track.search`	2 créditos	Búsqueda de tareas u objetivos
`suggestion.search`	2 créditos	Listado o sugerencias de búsqueda
`alias.list`	2 créditos	Alias de listado
`standard_call`	1 crédito	Lee, escribe, aplica en masa, me gusta, elimina alias, obtiene/actualiza/resuelve sugerencias
`llm_generation`	Uso de tokens de IA	Funciones basadas en LLM, como chat y generación de reseñas

Las lecturas del paquete cuestan 1 crédito ya sea que solicite el esquema, seleccione blockIds / stepIds o full=true. Prefiera lecturas esquemáticas y selectivas para mantener pequeño el contexto del agente, no para reducir el costo del crédito.

Las operaciones de escritura se cobran como llamadas estándar. La validación fallida no consume créditos.

La gestión de cuentas y espacios de trabajo no consume créditos: los espacios de trabajo, los proyectos, los miembros, los agentes instalados, la autenticación y la consulta del saldo o la compra de créditos son gratuitos. Las operaciones de paquete, seguimiento, alias y sugerencias utilizan los costos fijos anteriores; Las funciones basadas en LLM utilizan créditos basados en tokens.

Epismo verifica su saldo antes de que se ejecute una operación de costo fijo y solo cuenta el crédito una vez que la operación se realiza correctamente, por lo que no se cobra una búsqueda o lectura fallida. El uso de LLM se cobra a partir de los tokens que consumió el modelo. Una operación controlada por créditos puede devolver 402 Payment Required cuando el contexto seleccionado no tiene suficientes créditos.

Orientación operativa

Consultar saldo antes de obtener trabajos por lotes que realizan muchas búsquedas o detalles.
Prefiera lecturas de esquemas y paquetes selectivos para mantener pequeño el contexto del agente.
Utilice tokens con ámbito de espacio de trabajo en CI para que los créditos se consuman desde el espacio de trabajo previsto.