Limitaciones
Esta página se centra en las herramientas MCP (nombres como generate_media, get_models). Las rutas de la API REST usan ideas similares pero nombres de ruta distintos y algunos cubos de ritmo diferentes (p. ej. POST /v1/upload/media); consulta API REST.
#Límites de ritmo
Las solicitudes están limitadas por minuto por cuenta (o por token de cliente conectado). Límites aproximados:
| Herramienta o categoría | Límite (solicitudes por minuto) |
|---|---|
| generate_media | 30 |
| generate_music | 10 |
| generate_dialogue | 10 (cubo separado) |
| create_ad_copy | 5 |
| get_generation_status, get_music_status, get_models, get_balance, get_generations, get_generation_estimate | 120 |
Si superas el límite, el servidor devuelve un error de rate limited. Espera un momento (p. ej. hasta el siguiente minuto) antes de reintentar. Tu cliente puede mostrar algo como «Demasiadas solicitudes» o «Rate limit exceeded».
#Créditos
- Todas las generaciones (medios, música, anuncios) consumen créditos Kubeez de tu cuenta.
- El coste depende del modelo y las opciones (p. ej. calidad, duración). Usa get_models para ver el coste por generación de cada modelo.
- Antes de iniciar un trabajo, usa get_balance para asegurarte de tener créditos suficientes. Si no los tienes, la solicitud puede fallar con error de créditos insuficientes.
- Puedes comprar o recargar créditos en tu cuenta Kubeez.
#Errores
- Rate limited — Demasiadas solicitudes en poco tiempo. Reintenta tras una breve espera.
- Insufficient credits — Tu saldo es demasiado bajo para la operación. Añade créditos en tu cuenta Kubeez.
- Invalid or expired token — Vuelve a autorizar el cliente MCP desde Kubeez (p. ej. desconecta y conecta de nuevo).
- Invalid parameters — p. ej. modelo incorrecto para el tipo de generación elegido, o falta imagen de entrada cuando el modelo la exige. Revisa get_models y la documentación de la herramienta (p. ej. Herramientas de medios).
#Límites específicos por herramienta
#generate_dialogue
- Mínimo de caracteres: 5 caracteres en total.
- Máximo de caracteres: 5.000 caracteres en total por generación.
- Trabajos concurrentes: Hasta 5 generaciones a la vez.
#generate_media
- Trabajos concurrentes: Hasta 10 generaciones a la vez.
#generate_music
- Trabajos concurrentes: Hasta 5 generaciones a la vez.
Cuando una generación falla, la respuesta de estado suele incluir un mensaje de error que describe el problema.
Consulta Cómo funciona para flujos recomendados y reintentos.