> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Consumo

> Cómo se mide el uso y cómo consultar el resumen de cobro de la cuenta

Esta página explica **cómo se mide su consumo** y los endpoints para seguir el ciclo. El cobro Enterprise se basa en el uso, así que conviene entender qué cuenta y cómo se forma el total del ciclo.

## Qué se mide

La unidad de medida es el **día de instancia activa**. Para cada instancia en cobro, la API cuenta los días comprometidos en el ciclo, y el total del ciclo es la suma de esos días de todas sus instancias.

* Una instancia activa todo el ciclo cuenta el ciclo completo.
* Una instancia que entra en cobro a mitad del ciclo compromete los días desde ahí hasta la renovación.
* Eliminar una instancia no reduce los días ya comprometidos. Vea [Cómo funciona el cobro](/es/enterprise/how-billing-works).
* Una instancia aún en prueba no entra en el conteo mientras esté en ese estado.

## Resumen de cobro de la cuenta

**`GET /api/account/billing/summary`**

Devuelve el resumen del ciclo vigente de la cuenta. Autentique con el **TokenAccount** de la cuenta, o con el token global pasando `?account=<nombre-de-la-cuenta>`.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://ryzeapi.cloud/api/account/billing/summary" \
    -H "token: $Token_Account"
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://ryzeapi.cloud/api/account/billing/summary", {
    headers: { "token": process.env.Token_Account }
  });
  ```
</CodeGroup>

```json 200 OK theme={null}
{
  "enterprise": true,
  "baseCents": 50000,
  "committedCents": 42000,
  "projectedChargeCents": 50000,
  "billableInstanceDays": 210,
  "billableCount": 8,
  "cycleStart": "2026-08-01T00:00:00Z",
  "cycleEnd": "2026-09-01T00:00:00Z",
  "nextChargeAt": "2026-09-01T00:00:00Z"
}
```

<ResponseField name="enterprise" type="boolean">
  `true` cuando la cuenta es Enterprise. Si viene `false`, los demás campos no aparecen.
</ResponseField>

<ResponseField name="baseCents" type="integer">
  El crédito mensual (base) de su contrato, en centavos. Es el piso de la factura.
</ResponseField>

<ResponseField name="committedCents" type="integer">
  El monto de uso ya comprometido en el ciclo, en centavos, proporcional a los días de instancia.
</ResponseField>

<ResponseField name="projectedChargeCents" type="integer">
  La proyección del cobro del ciclo, en centavos: el mayor entre `baseCents` y `committedCents`.
</ResponseField>

<ResponseField name="billableInstanceDays" type="integer">
  La suma de días de instancia en cobro en el ciclo.
</ResponseField>

<ResponseField name="billableCount" type="integer">
  El pico de instancias simultáneas en cobro en el ciclo.
</ResponseField>

<ResponseField name="cycleStart" type="string">
  Inicio del ciclo vigente.
</ResponseField>

<ResponseField name="cycleEnd" type="string">
  Fin del ciclo vigente.
</ResponseField>

<ResponseField name="nextChargeAt" type="string">
  Cuándo ocurre el próximo cobro (el fin del ciclo).
</ResponseField>

<Note>
  Antes de la primera renovación, la ventana del ciclo puede aún no estar completada, y el resumen muestra la `base` como piso proyectado.
</Note>

## Cobro por instancia en el listado

**`GET /api/instance/list`** ya trae, para cada instancia, un bloque `billing` con el estado de cobro. Aparece solo en llamadas con token de cuenta o global, nunca con token de instancia.

```json theme={null}
{
  "billing": {
    "billingMode": "trial",
    "trialEndsAt": "2026-08-25T12:00:00Z",
    "billableSince": null,
    "trialDaysLeft": 5,
    "willBeCharged": false
  }
}
```

<ResponseField name="billingMode" type="string">
  `trial` o `billable`.
</ResponseField>

<ResponseField name="trialEndsAt" type="string | null">
  Cuándo termina la prueba. `null` cuando la instancia ya está en cobro.
</ResponseField>

<ResponseField name="billableSince" type="string | null">
  Desde cuándo se cobra la instancia. `null` mientras está en prueba.
</ResponseField>

<ResponseField name="trialDaysLeft" type="integer">
  Días que faltan de la prueba, redondeado hacia arriba. `0` fuera de la prueba.
</ResponseField>

<ResponseField name="willBeCharged" type="boolean">
  `true` cuando la instancia ya está en cobro.
</ResponseField>

## Seguimiento en tiempo real

Para reaccionar a cada cambio de estado, use los [webhooks Enterprise](/es/enterprise/webhooks). Avisan cuando una prueba comienza, cuando está por terminar y cuando una instancia pasa a cobro, lo que le permite reflejar ese estado en su propio panel.

## Siguiente

<CardGroup cols={2}>
  <Card title="Extracto de uso" icon="receipt" href="/es/enterprise/statement">
    La factura con detalle del período, instancia por instancia.
  </Card>

  <Card title="Historial de conexiones" icon="link" href="/es/enterprise/connections">
    La línea de tiempo de cuándo estuvo conectado cada número.
  </Card>

  <Card title="Cómo funciona el cobro" icon="calculator" href="/es/enterprise/how-billing-works">
    Crédito, prueba y el modelo comprometido en detalle.
  </Card>

  <Card title="Webhooks Enterprise" icon="webhook" href="/es/enterprise/webhooks">
    Siga los cambios de estado en tiempo real.
  </Card>
</CardGroup>