feat(i18n): update translations (#2275)

Co-authored-by: icecrasher321 <icecrasher321@users.noreply.github.com>
2026-04-28 03:00:29 -04:00 · 2025-12-09 15:25:03 -08:00
parent aea32d423f
commit cc66aa5a3e
11 changed files with 378 additions and 221 deletions
--- a/apps/docs/content/docs/es/execution/api.mdx
+++ b/apps/docs/content/docs/es/execution/api.mdx
@@ -27,14 +27,16 @@ Todas las respuestas de la API incluyen información sobre tus límites de ejecu
 "limits": {
  "workflowExecutionRateLimit": {
    "sync": {
-      "limit": 60,        // Max sync workflow executions per minute
-      "remaining": 58,    // Remaining sync workflow executions
-      "resetAt": "..."    // When the window resets
+      "requestsPerMinute": 60,  // Sustained rate limit per minute
+      "maxBurst": 120,          // Maximum burst capacity
+      "remaining": 118,         // Current tokens available (up to maxBurst)
+      "resetAt": "..."          // When tokens next refill
    },
    "async": {
-      "limit": 60,        // Max async workflow executions per minute
-      "remaining": 59,    // Remaining async workflow executions
-      "resetAt": "..."    // When the window resets
+      "requestsPerMinute": 200, // Sustained rate limit per minute
+      "maxBurst": 400,          // Maximum burst capacity
+      "remaining": 398,         // Current tokens available
+      "resetAt": "..."          // When tokens next refill
    }
  },
  "usage": {
@@ -46,7 +48,7 @@ Todas las respuestas de la API incluyen información sobre tus límites de ejecu
 }
 ```

-**Nota:** Los límites de tasa en el cuerpo de la respuesta son para ejecuciones de flujos de trabajo. Los límites de tasa para llamar a este endpoint de la API están en los encabezados de respuesta (`X-RateLimit-*`).
+**Nota:** Los límites de tasa utilizan un algoritmo de cubo de tokens. `remaining` puede exceder `requestsPerMinute` hasta `maxBurst` cuando no has usado tu asignación completa recientemente, permitiendo tráfico en ráfagas. Los límites de tasa en el cuerpo de la respuesta son para ejecuciones de flujo de trabajo. Los límites de tasa para llamar a este punto final de la API están en los encabezados de respuesta (`X-RateLimit-*`).

 ### Consultar registros

@@ -110,13 +112,15 @@ Consulta los registros de ejecución de flujos de trabajo con amplias opciones d
      "limits": {
        "workflowExecutionRateLimit": {
          "sync": {
-            "limit": 60,
-            "remaining": 58,
+            "requestsPerMinute": 60,
+            "maxBurst": 120,
+            "remaining": 118,
            "resetAt": "2025-01-01T12:35:56.789Z"
          },
          "async": {
-            "limit": 60,
-            "remaining": 59,
+            "requestsPerMinute": 200,
+            "maxBurst": 400,
+            "remaining": 398,
            "resetAt": "2025-01-01T12:35:56.789Z"
          }
        },
@@ -190,13 +194,15 @@ Recupera información detallada sobre una entrada de registro específica.
        "limits": {
          "workflowExecutionRateLimit": {
            "sync": {
-              "limit": 60,
-              "remaining": 58,
+              "requestsPerMinute": 60,
+              "maxBurst": 120,
+              "remaining": 118,
              "resetAt": "2025-01-01T12:35:56.789Z"
            },
            "async": {
-              "limit": 60,
-              "remaining": 59,
+              "requestsPerMinute": 200,
+              "maxBurst": 400,
+              "remaining": 398,
              "resetAt": "2025-01-01T12:35:56.789Z"
            }
          },
@@ -482,19 +488,27 @@ Las entregas de webhook fallidas se reintentan con retroceso exponencial y fluct

 ## Limitación de tasa

-La API implementa limitación de tasa para asegurar un uso justo:
+La API utiliza un **algoritmo de cubo de tokens** para limitar la tasa, proporcionando un uso justo mientras permite tráfico en ráfagas:

- **Plan gratuito**: 10 solicitudes por minuto
- **Plan Pro**: 30 solicitudes por minuto
- **Plan Team**: 60 solicitudes por minuto
- **Plan Enterprise**: Límites personalizados
+| Plan | Solicitudes/Minuto | Capacidad de ráfaga |
+|------|-----------------|----------------|
+| Free | 10 | 20 |
+| Pro | 30 | 60 |
+| Team | 60 | 120 |
+| Enterprise | 120 | 240 |

-La información de límite de tasa se incluye en las cabeceras de respuesta:
- `X-RateLimit-Limit`: Solicitudes máximas por ventana
- `X-RateLimit-Remaining`: Solicitudes restantes en la ventana actual
- `X-RateLimit-Reset`: Marca de tiempo ISO cuando la ventana se reinicia
+**Cómo funciona:**
+- Los tokens se recargan a una tasa de `requestsPerMinute`
+- Puedes acumular hasta `maxBurst` tokens cuando estás inactivo
+- Cada solicitud consume 1 token
+- La capacidad de ráfaga permite manejar picos de tráfico

-## Ejemplo: Sondeo de nuevos registros
+La información del límite de tasa se incluye en los encabezados de respuesta:
+- `X-RateLimit-Limit`: Solicitudes por minuto (tasa de recarga)
+- `X-RateLimit-Remaining`: Tokens disponibles actualmente
+- `X-RateLimit-Reset`: Marca de tiempo ISO cuando los tokens se recargan nuevamente
+
+## Ejemplo: Sondeo para nuevos registros

 ```javascript
 let cursor = null;
--- a/apps/docs/content/docs/es/execution/costs.mdx
+++ b/apps/docs/content/docs/es/execution/costs.mdx
@@ -147,8 +147,20 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
 {
  "success": true,
  "rateLimit": {
-    "sync": { "isLimited": false, "limit": 10, "remaining": 10, "resetAt": "2025-09-08T22:51:55.999Z" },
-    "async": { "isLimited": false, "limit": 50, "remaining": 50, "resetAt": "2025-09-08T22:51:56.155Z" },
+    "sync": {
+      "isLimited": false,
+      "requestsPerMinute": 25,
+      "maxBurst": 50,
+      "remaining": 50,
+      "resetAt": "2025-09-08T22:51:55.999Z"
+    },
+    "async": {
+      "isLimited": false,
+      "requestsPerMinute": 200,
+      "maxBurst": 400,
+      "remaining": 400,
+      "resetAt": "2025-09-08T22:51:56.155Z"
+    },
    "authType": "api"
  },
  "usage": {
@@ -159,6 +171,11 @@ curl -X GET -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" htt
 }
 ```

+**Campos de límite de tasa:**
+- `requestsPerMinute`: Límite de tasa sostenida (los tokens se recargan a esta velocidad)
+- `maxBurst`: Máximo de tokens que puedes acumular (capacidad de ráfaga)
+- `remaining`: Tokens disponibles actualmente (puede ser hasta `maxBurst`)
+
 **Campos de respuesta:**
 - `currentPeriodCost` refleja el uso en el período de facturación actual
 - `limit` se deriva de límites individuales (Gratuito/Pro) o límites agrupados de la organización (Equipo/Empresa)
@@ -170,38 +187,38 @@ Los diferentes planes de suscripción tienen diferentes límites de uso:

 | Plan | Límite de uso mensual | Límites de tasa (por minuto) |
 |------|-------------------|-------------------------|
-| **Gratuito** | $10 | 5 sinc, 10 asinc |
-| **Pro** | $100 | 10 sinc, 50 asinc |
-| **Equipo** | $500 (agrupado) | 50 sinc, 100 asinc |
+| **Gratuito** | $10 | 5 sincrónico, 10 asincrónico |
+| **Pro** | $100 | 10 sincrónico, 50 asincrónico |
+| **Equipo** | $500 (agrupado) | 50 sincrónico, 100 asincrónico |
 | **Empresa** | Personalizado | Personalizado |

 ## Modelo de facturación

-Sim utiliza un modelo de facturación de **suscripción base + exceso**:
+Sim utiliza un modelo de facturación de **suscripción base + excedente**:

 ### Cómo funciona

 **Plan Pro ($20/mes):**
 - La suscripción mensual incluye $20 de uso
 - Uso por debajo de $20 → Sin cargos adicionales
- Uso por encima de $20 → Pagas el exceso al final del mes
- Ejemplo: $35 de uso = $20 (suscripción) + $15 (exceso)
+- Uso por encima de $20 → Pagas el excedente al final del mes
+- Ejemplo: $35 de uso = $20 (suscripción) + $15 (excedente)

-**Plan de equipo ($40/usuario/mes):**
+**Plan de Equipo ($40/usuario/mes):**
 - Uso agrupado entre todos los miembros del equipo
- Exceso calculado del uso total del equipo
+- Excedente calculado del uso total del equipo
 - El propietario de la organización recibe una sola factura

-**Planes empresariales:**
- Precio mensual fijo, sin excesos
+**Planes Empresariales:**
+- Precio mensual fijo, sin excedentes
 - Límites de uso personalizados según el acuerdo

 ### Facturación por umbral

-Cuando el exceso no facturado alcanza los $50, Sim factura automáticamente el monto total no facturado.
+Cuando el excedente no facturado alcanza los $50, Sim factura automáticamente el monto total no facturado.

 **Ejemplo:**
- Día 10: $70 de exceso → Factura inmediata de $70
+- Día 10: $70 de excedente → Factura inmediata de $70
 - Día 15: $35 adicionales de uso ($105 en total) → Ya facturado, sin acción
 - Día 20: Otros $50 de uso ($155 en total, $85 no facturados) → Factura inmediata de $85

@@ -209,8 +226,8 @@ Esto distribuye los cargos por exceso a lo largo del mes en lugar de una gran fa

 ## Mejores prácticas para la gestión de costos

-1. **Monitorear regularmente**: Revisa tu panel de uso frecuentemente para evitar sorpresas
-2. **Establecer presupuestos**: Usa los límites del plan como guías para tu gasto
+1. **Monitorear regularmente**: Revisa tu panel de uso con frecuencia para evitar sorpresas
+2. **Establecer presupuestos**: Utiliza los límites del plan como guías para tu gasto
 3. **Optimizar flujos de trabajo**: Revisa las ejecuciones de alto costo y optimiza los prompts o la selección de modelos
 4. **Usar modelos apropiados**: Ajusta la complejidad del modelo a los requisitos de la tarea
 5. **Agrupar tareas similares**: Combina múltiples solicitudes cuando sea posible para reducir la sobrecarga