# Límites de tarifas y uso

Consulta la capacidad de tu cuenta, gestiona los límites de solicitudes y sigue el trabajo completado.

Referencia canónica: https://flashdata.dev/es/docs/guides/usage-and-limits
Revisado: 2026-11-04 por FlashData

<a id="limits"></a>

## Compruebe sus límites

Los límites siguen su cuenta y plan. Ejecute este cheque gratuito con la clave que enviará el trabajo; todas las claves de la cuenta comparten la misma capacidad.

### CLI

Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.

#### Consultar la cuenta gratis

```bash
flashdata account limits
```

- [Configurar una clave](https://flashdata.dev/es/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Requiere Bash y cURL 7.76+. Si FLASHDATA_API_KEY ya está definida en tu entorno, omite el paso para introducirla. Ejecuta los comandos en la misma terminal.

#### Define la clave si aún no está configurada

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```

#### Leer el JSON de la cuenta

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/limits' || exit
printf '\n'
)
```


### PowerShell 7

Si FLASHDATA_API_KEY ya está definida, omite el paso para introducirla. Ejecuta los comandos en la misma terminal.

#### Define la clave si aún no está configurada

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```

#### Leer el JSON de la cuenta

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/limits"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="capacity"></a>

### Entender cada límite

Empieza con una solicitud en curso y aumenta la concurrencia dentro de los límites indicados. Los endpoints HTTP de lectura y el registro de pruebas tienen sus propios límites de frecuencia; estos campos de capacidad no son cuotas de solicitudes por minuto.

| Campo | Significado |
| --- | --- |
| limits.concurrency | Planifique el techo para el trabajo simultáneo, no un recuento de ranuras gratuitas. |
| limits.batchSize | Artículos máximos en una presentación por lotes. |
| limits.pendingJobs | Máximo trabajo pendiente para la cuenta. |
| current.pendingJobs | Cuento pendiente en el momento de la lectura. Puede cambiar antes de la presentación. |

- [Límites del registro de pruebas](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

## Maneje una respuesta 429

Lea el cuerpo de error y el encabezado Retry-After. Para inspeccionar una cuenta gratuita, ejecute esto en un terminal Bash donde se establece FLASHDATA_API_KEY. Los encabezados están escritos a limits-headers.txt y la respuesta a limits.json.

### Estado de captura, cabeceras y cuerpo · Bash / cURL

```bash
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}" \
  --dump-header limits-headers.txt --output limits.json \
  --write-out 'HTTP %{http_code}\n' \
  https://api.flashdata.dev/v2/api-access/limits
cat limits-headers.txt limits.json
```


<a id="retry-example"></a>

### Espera antes de volver a intentarlo.

Este ejemplo significa esperar al menos segundos 60. Retry-After también puede ser una fecha HTTP. Utilice el valor devuelto, no un retraso fijo.

#### Cabeceras de respuesta ilustrativa

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

### Elija la siguiente acción

| Situación | Medida |
| --- | --- |
| Capacidad plena | Reducir la concurrencia o esperar a que terminen los trabajos pendientes. |
| No Retry-After | Use el backoff capped con jitter y un límite de retry finito. |
| Registro limitado | Espera, luego vuelve a entrar con el mismo perfil, entrada y prueba. No cambie IPs. |
| Fecha límite de presentación | Inspeccione el funcionamiento o el trabajo existentes antes de volver a presentar; su resultado es desconocido. |

- [Recuperar una tarea interrumpida](https://flashdata.dev/es/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

## Uso de la cuenta

La ventana predeterminada es los últimos siete días. El uso cubre todas las teclas de cuenta, restringidas a las fuentes que esta clave puede acceder.

### CLI

Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.

#### Consultar la cuenta gratis

```bash
flashdata account usage
```

- [Configurar una clave](https://flashdata.dev/es/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo terminal.

#### Leer el JSON de la cuenta

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/usage' || exit
printf '\n'
)
```


### PowerShell 7

Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo terminal.

#### Leer el JSON de la cuenta

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/usage"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```



<a id="usage-result"></a>

### Comprobación del trabajo y los créditos terminados

Lea los totales y bySource, a continuación, compare de y a con sus registros de tareas. CLI JSON envuelve la respuesta en datos. Las solicitudes recientes o los reembolsos pueden tomar tiempo para aparecer, incluso cuando la actualización es falsa.

#### Illustrative response extractopt

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [Inspeccionar un trabajo en Historia](https://flashdata.dev/app/jobs)
- [Entender cargos](https://flashdata.dev/es/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

### Filtrar una fuente y rango de fecha

Sustitúyase las fechas de UTC con su período de presentación, hasta los días de 31. desde es inclusivo y hasta exclusivo; ambos se redondean hasta minutos. Esto lee el uso existente solamente.

#### Ejemplo de ventana de presentación de informes

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

