| La herramienta MCP no se autentica |
Falta la clave de API, está mal escrita o no está disponible para el proceso del cliente. |
Confirma que la variable de entorno se llame exactamente FREEBEAT_API_KEY y reinicia el cliente MCP después de modificar su configuración. |
| Se rechaza el modelo seleccionado |
Es posible que el identificador del modelo esté desactualizado o no aparezca en la lista actual de modelos de video. |
Vuelve a llamar a list_models y utiliza el identificador devuelto para el modelo de video seleccionado. |
| La solicitud de generación no supera la validación |
La instrucción no tiene la longitud permitida o algún ajuste entra en conflicto con las restricciones del modelo. |
Recorta la instrucción para que tenga entre 1 y 2.000 caracteres y verifica la duración, la resolución, la relación de aspecto y la compatibilidad con audio mediante get_model_help. |
| No aparece una URL de video de inmediato |
La solicitud de generación se ejecuta de forma asíncrona y aún no ha terminado. |
Consulta get_task_status con el ID de lote devuelto e inspecciona los elementos cuando se complete. |
| Una tarea termina con estado de error |
El backend informa de un error, a veces con un mensaje o código de error. |
Lee los campos de error de la respuesta de estado, corrige la solicitud o los ajustes que indiquen y envía una nueva tarea de generación. |