Uso
Devuelve el consumo actual del período de facturación en curso: créditos de IA y re-sincronización (a nivel organización y desglosados por agente), agentes y capacidad de base de conocimiento.GET https://app.chatnorris.ai/api/v2/usage
Authorization: Bearer <tu_api_key>
Respuesta
{
"status": "success",
"data": {
"messages": {
"used": 3420,
"limit": 5000
},
"chatbots": {
"used": 3,
"limit": 5
},
"knowledge_base_chars": {
"used": 820000,
"limit": 5000000
},
"credits": {
"ai": {
"used": 1200,
"limit": 3000,
"remaining": 1800
},
"resync": {
"used": 500,
"limit": 15000,
"remaining": 14500
}
},
"chatbot_credits": [
{
"id": "bot_xyz789",
"name": "Agente de soporte",
"credits": {
"ai": {
"used": 300,
"limit": 500,
"remaining": 200
}
}
}
],
"period": {
"start": "2026-06-01T00:00:00.000Z",
"end": "2026-07-01T00:00:00.000Z"
}
}
}
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
messages.used | integer | Alias heredado: hoy refleja el mismo consumo que credits.ai.used, mantenido por compatibilidad. Preferí credits.ai para integraciones nuevas. |
messages.limit | integer | Alias heredado del límite de la bolsa ai (-1 = ilimitado) |
chatbots.used | integer | Agentes creados actualmente |
chatbots.limit | integer | Límite de agentes del plan (-1 = ilimitado) |
knowledge_base_chars.used | integer | Caracteres indexados en la KB |
knowledge_base_chars.limit | integer | Límite de caracteres del plan (-1 = ilimitado) |
credits.ai | object | Consumo de la bolsa de créditos de IA de la organización en el período actual |
credits.resync | object | Consumo de la bolsa de créditos de re-sincronización de la organización en el período actual |
credits.<bucket>.used | number | Créditos consumidos de esa bolsa en el período actual |
credits.<bucket>.limit | number | null | Límite de esa bolsa (null = ilimitado) |
credits.<bucket>.remaining | number | null | Créditos restantes de esa bolsa (null si el límite es ilimitado) |
chatbot_credits | array | Desglose de consumo de créditos por agente |
chatbot_credits[].id | string | ID del agente |
chatbot_credits[].name | string | Nombre del agente |
chatbot_credits[].credits.ai.limit / .remaining | number | null | Solo tienen valor si ese agente tiene un tope de créditos propio activado (Configuración del agente → Límites); si no, son null |
period.start | string | Inicio del período de facturación (ISO 8601) |
period.end | string | Fin del período de facturación / fecha de reset de contadores (ISO 8601) |
Un valor de
-1 o null (según el campo) indica que ese recurso es ilimitado en tu plan actual.