> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Límites de cuota
Agent Sandbox aplica límites de cuota según el nivel de tu cuenta. Las cuotas definen los recursos y las capacidades disponibles para cada nivel.
Si necesitas límites más altos, contacta con nuestro equipo de soporte.
## Niveles de cuenta
| Nivel de cuenta | Descripción |
| --------------- | --------------------------------------------------------------------------------------------- |
| Gratis | El nivel predeterminado para usuarios nuevos. |
| De pago | Disponible después de añadir saldo a la cuenta o habilitar una línea de crédito. |
| Enterprise | Diseñado para clientes empresariales que necesitan límites personalizados y soporte dedicado. |
## Cuotas predeterminadas
| Límite | Gratis | De pago | Enterprise |
| ---------------------------- | --------- | --------- | ------------------------------------------ |
| Sandboxes concurrentes | 5 | 100 | 500 de forma predeterminada, ajustable |
| Duración máxima de la sesión | 1 hora | 3 horas | 4 horas de forma predeterminada, ajustable |
| vCPU máximo | 2 vCPU | 8 vCPU | 8 vCPU de forma predeterminada, ajustable |
| Memoria máxima | 4 GiB | 8 GiB | 8 GiB de forma predeterminada, ajustable |
| Espacio en disco local | 20 GB | 20 GB | 20 GB de forma predeterminada, ajustable |
| Incremento de memoria | 512 MiB | 512 MiB | 512 MiB |
| Memoria por vCPU | 0.5-4 GiB | 0.5-4 GiB | 0.5-4 GiB |
## Reglas de configuración
Al configurar CPU y memoria, tu configuración debe cumplir los siguientes requisitos:
* vCPU no debe superar el límite máximo de vCPU para el nivel de tu cuenta.
* La memoria no debe superar el límite máximo de memoria para el nivel de tu cuenta.
* vCPU debe configurarse como un valor entero, como 1, 2, 4 u 8 vCPU.
* La memoria debe configurarse en incrementos de 512 MiB.
* La memoria debe estar dentro del rango permitido de 0.5-4 GiB por vCPU.
Por ejemplo:
* 1 vCPU admite de 512 MiB a 4 GiB de memoria.
* 2 vCPU admiten de 1 GiB a 8 GiB de memoria.
* 4 vCPU pueden admitir hasta 16 GiB de memoria según el rango de memoria por vCPU, pero la memoria real disponible sigue estando limitada por la cuota máxima de memoria del nivel de tu cuenta.
La configuración final disponible se determina tanto por los límites del nivel de tu cuenta como por el rango permitido de memoria por vCPU.
## Comprobar el uso actual de la cuota
Usa la API de cuotas para comprobar los límites de cuota disponibles para tu cuenta y los recursos actualmente en uso. Esto es útil antes de iniciar un lote grande de sandboxes o al solucionar errores de inicio relacionados con cuotas.
### Comprobar el uso de la cuota con los SDKs
```js JavaScript & TypeScript icon="js" theme={"system"}
import { Sandbox } from 'novita-sandbox'
const quota = await Sandbox.getQuota()
console.log('Quota limit:', quota.limit)
console.log('Current usage:', quota.usage)
// Example shape:
// {
// limit: {
// concurrentInstances: 100,
// concurrentVcpu: 200,
// concurrentRamMb: 409600,
// maxLengthHours: 4,
// diskMb: 20480,
// maxVcpu: 8,
// maxRamMb: 8192
// },
// usage: {
// concurrentInstances: 12,
// concurrentVcpu: 24,
// concurrentRamMb: 49152
// }
// }
```
```python Python icon="python" theme={"system"}
from novita_sandbox.core import Sandbox
quota = Sandbox.get_quota()
print('Quota limit:', quota.limit)
print('Current usage:', quota.usage)
# Example shape:
# {
# "limit": {
# "concurrentInstances": 100,
# "concurrentVcpu": 200,
# "concurrentRamMb": 409600,
# "maxLengthHours": 4,
# "diskMb": 20480,
# "maxVcpu": 8,
# "maxRamMb": 8192,
# },
# "usage": {
# "concurrentInstances": 12,
# "concurrentVcpu": 24,
# "concurrentRamMb": 49152,
# },
# }
```
### Campos de la respuesta de cuota
La respuesta de cuota incluye los objetos `limit` y `usage`.
| Campo | Descripción |
| --------------------------- | ---------------------------------------------------------------------------------------- |
| `limit.concurrentInstances` | Número máximo de sandboxes que pueden ejecutarse simultáneamente. |
| `limit.concurrentVcpu` | Número máximo total de núcleos vCPU que pueden usarse simultáneamente. |
| `limit.concurrentRamMb` | RAM total máxima que puede usarse simultáneamente, en MB. |
| `limit.maxLengthHours` | Vida útil máxima de un único sandbox, en horas. |
| `limit.diskMb` | Almacenamiento de runtime disponible para un único sandbox, en MB. |
| `limit.maxVcpu` | Núcleos vCPU máximos para un único sandbox. Se aplica después de compilar la plantilla. |
| `limit.maxRamMb` | Memoria máxima para un único sandbox, en MB. Se aplica después de compilar la plantilla. |
| `usage.concurrentInstances` | Número actual de sandboxes en ejecución. |
| `usage.concurrentVcpu` | Total actual de núcleos vCPU en uso. |
| `usage.concurrentRamMb` | RAM total actual en uso, en MB. |
El uso de cuotas está pensado para la planificación de capacidad y la solución de problemas. Los datos de uso pueden tener un breve retraso, según la ruta de informes de recursos del backend.
## Notas
* Si tu configuración de recursos supera la cuota para el nivel de tu cuenta, la solicitud fallará.
* Si una región no tiene capacidad disponible, la creación de sandboxes puede fallar con un error relacionado con cuotas o límites de frecuencia, incluso cuando tu cuota a nivel de cuenta no se haya utilizado por completo.
* Elige CPU y memoria según los requisitos de tu carga de trabajo para evitar errores de falta de memoria o un uso innecesario de recursos.
* Las cuotas de Enterprise pueden personalizarse según tus requisitos. Para solicitar un aumento de cuota, contacta con nuestro equipo de soporte.