# Planes, facturación y límites

Hay dos formas de pagar las APIs en Zyla API Hub. Usa la que mejor se adapte a tu forma de trabajar; puedes usar ambas desde la misma cuenta.

## Dos formas de pagar

| | Pago por llamada | Plan mensual |
|---|---|---|
| **Ideal para** | Agentes de IA y uso ocasional | Uso constante de una API desde tu propio software |
| **Cómo funciona** | Tu agente llama a cualquier API a través del [servidor MCP de Zyla](https://zylalabs.com/es/docs/mcp). Cada llamada exitosa se cobra al precio por llamada de esa API | Te suscribes a un plan en la página de la API: una cantidad de llamadas por mes por un precio fijo |
| **Suscripción** | Ninguna. Pagas solo por las llamadas que tienen éxito | Una por API. Se renueva automáticamente hasta que la cancelas |
| **Necesitas** | Una tarjeta de crédito registrada | Un plan para cada API que uses |

**Pago por llamada.** Sin cuota mensual y sin mínimo. Si falta la tarjeta, tu agente recibe un enlace de pago (`402`) para abrirlo y agregarla. Pídele a tu agente tu *estado de cuenta* para ver lo que has gastado en este ciclo.

**Planes mensuales.** Cada API tiene sus propios planes, definidos por su proveedor: precio, llamadas por mes y un límite de solicitudes por minuto. Algunas APIs ofrecen una prueba gratuita con pocas llamadas. Puedes subir de plan, bajar de plan o cancelar desde la página de la API en cualquier momento; los planes se renuevan automáticamente al final de cada periodo hasta que los cancelas. Las facturas y los métodos de pago están en **Billing**, en el menú de la cuenta. Los reembolsos siguen la [política de reembolsos](https://zylalabs.com/es/refund).

## Límites

- **Solicitudes por minuto.** Cada plan permite 60, 120 o 240 solicitudes por minuto. Por encima de eso, las llamadas se rechazan hasta que empiece el siguiente minuto.
- **Llamadas por mes.** Cuando usas todas las llamadas de tu plan, las llamadas se rechazan hasta que subas de plan o empiece el siguiente ciclo.
- **Facturas impagas.** Si una factura queda impaga por 72 horas, la suscripción se pausa hasta que se pague en el Billing Portal.

Los desarrolladores pueden rastrear su uso desde los headers de respuesta; consulta [Llama a una API por HTTP](https://zylalabs.com/es/docs/calling-apis).

## Cuando algo falla

Los errores del hub llegan con un `message` que indica qué pasó:

| Status | What it means | What to do |
|---|---|---|
| `401` | Clave ausente o incorrecta, sin suscripción a esta API, método HTTP incorrecto, o una prueba de cortesía vencida | Revisa la clave y la suscripción; los agentes se suscriben solos |
| `402` | Sin tarjeta de crédito registrada (agentes, pago por llamada) | Abre el enlace de pago y agrega una tarjeta |
| `403` | La cuenta está bloqueada, o la clave está limitada a otras APIs | Usa una clave permitida para esta API |
| `404` | La API o el endpoint no existe o no es público | Revisa la API y el endpoint |
| `410` | El endpoint fue retirado | Usa la alternativa indicada en la página de la API |
| `422` | Un parámetro tiene el tipo o formato incorrecto | Corrige el parámetro indicado en el mensaje |
| `429` | Demasiadas solicitudes por minuto, se agotaron las llamadas del plan o de la prueba, o una suscripción pausada | Espera, sube de plan o paga la factura pendiente |

Cualquier otro estado (por ejemplo, un `400` o `500` con el mensaje propio del proveedor) viene de la API misma. Si persiste, escribe a nuestro equipo con el nombre de la API y la hora de la llamada.


---
Source: https://zylalabs.com/es/docs/plans-and-limits
