| A ferramenta MCP não autentica |
A chave de API está ausente, foi digitada incorretamente ou não está disponível para o processo do cliente. |
Confirme que o nome da variável de ambiente é exatamente FREEBEAT_API_KEY e reinicie o cliente MCP após alterar a configuração. |
| O modelo selecionado é rejeitado |
O identificador do modelo pode estar desatualizado ou não aparecer na lista atual de modelos de vídeo. |
Chame list_models novamente e use o identificador retornado para o modelo de vídeo selecionado. |
| A solicitação de geração falha na validação |
O prompt está fora do limite de tamanho permitido ou uma configuração entra em conflito com as restrições do modelo. |
Ajuste o prompt para que tenha de 1 a 2.000 caracteres e verifique a duração, a resolução, a proporção e o suporte a áudio com get_model_help. |
| A URL do vídeo não aparece imediatamente |
A solicitação de geração é executada de forma assíncrona e ainda não foi concluída. |
Consulte get_task_status com o ID de lote retornado e inspecione os itens após a conclusão. |
| Uma tarefa chega ao status de falha |
O backend informa uma falha, às vezes acompanhada de uma mensagem ou código de erro. |
Leia os campos de erro da resposta de status, corrija a solicitação ou as configurações indicadas e envie uma nova tarefa de geração. |