---
title: Cuenta y saldo
description: GET /v1/account — el saldo disponible de la cuenta en créditos, además del número de solicitudes y los créditos gastados por esta clave en los últimos 30 días.
icon: Wallet
---

Obtenga el saldo disponible de la cuenta en créditos y las estadísticas de uso de la clave.

## Playground

<ApiPlayground path="/v1/account" method="get" />

`GET /v1/account` devuelve el saldo de la cuenta a la que pertenece la clave y un resumen de esta clave en los últimos 30 días. Sirve cualquier clave válida: no se necesita ningún permiso adicional.

<Method name="GET" path="/v1/account" />

## Solicitud

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl https://api.clipia.ai/v1/account \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

</Tab>
<Tab value="TypeScript">

```ts
const account = await clipia.account.get();
console.log(account.balance.credits);
```

</Tab>
<Tab value="Python">

```python
account = client.account.get()
print(account["balance"]["credits"])
```

</Tab>
</Tabs>

**Respuesta `200`**

```json
{
  "account_id": "8f3a1c7e-2b4d-4e6f-9a01-23456789abcd",
  "balance": { "credits": 1840 },
  "usage_30d": { "requests": 512, "credits_spent": 6120 }
}
```

<TypeTable
  type={{
    account_id: { type: 'string', description: 'Identificador de la cuenta' },
    'balance.credits': { type: 'integer', description: 'Saldo disponible: créditos de la suscripción y comprados, menos los créditos reservados para trabajos sin terminar' },
    'usage_30d.requests': { type: 'integer', description: 'Solicitudes a la API hechas con esta clave en los últimos 30 días, incluidas las consultas de estado' },
    'usage_30d.credits_spent': { type: 'number', description: 'Créditos cobrados a esta clave en los últimos 30 días, descontados los reembolsos' }
  }}
/>

<Callout type="info" title="Créditos">
Las generaciones y el chat con LLM descuentan créditos del saldo de la cuenta a la que pertenece la clave. Puede recargar el saldo en clipia.ai. Si no hay créditos suficientes, submit devuelve `402 insufficient_credits`.
</Callout>