Skip to main content
La API de Postzee aplica límites de tasa para garantizar un uso justo y la estabilidad de la plataforma. Los límites varían según el tipo de endpoint.

Límites de tasa por endpoint

Los endpoints con límites explícitos por minuto anulan el valor global por defecto. La mayoría de los endpoints de lectura (canales, créditos, posts, trabajos) caen bajo el límite global de 30/hora. Los endpoints de generación IA tienen sus propios límites de mayor frecuencia.

Límites de tasa del servidor MCP

Encabezados de límite de tasa

Cuando te acercas o excedes un límite de tasa, la API devuelve encabezados estándar de límite de tasa:

Exceder el límite

Cuando excedes el límite de tasa, la API devuelve:
Qué hacer: Espera a que la ventana del límite de tasa se reinicie (consulta el encabezado X-RateLimit-Reset), luego reintenta tu solicitud.

Mejores prácticas

  • Espacia las solicitudes de generación IA — limita a 10 por minuto para generación de imagen/video
  • Cachea listas de modelos — los modelos disponibles no cambian frecuentemente, así que cachea las respuestas de /image-models y /video-models
  • Consulta el estado de trabajos razonablemente — verifica cada 5-10 segundos, no cada segundo
  • Usa operaciones en lote — al generar múltiples imágenes, usa generate-media con quantity: 2-4 en lugar de múltiples llamadas a generate-image
  • Maneja el 429 con gracia — implementa retroceso exponencial cuando seas limitado

Límites por plan

Los límites de tasa son los mismos en todos los planes de pago. La API no está disponible en el plan Free.