| MCP tool does not authenticate |
The API key is missing, misspelled, or not available to the client process. |
Confirm the environment variable is named exactly FREEBEAT_API_KEY, then restart the MCP client after changing its configuration. |
| Selected model is rejected |
The model identifier may be stale or not returned by the current video-model list. |
Call list_models again and use the identifier returned for the selected video model. |
| Generation request fails validation |
The prompt is outside the allowed length or a setting conflicts with model constraints. |
Trim the prompt to 1–2,000 characters and verify duration, resolution, aspect ratio, and audio support with get_model_help. |
| No video URL appears immediately |
The generation request runs asynchronously and has not completed yet. |
Poll get_task_status with the returned batch ID and inspect the items after completion. |
| A task reaches failed status |
The backend reports a failure, sometimes with an error message or code. |
Read the status response’s error fields, correct the request or settings they identify, and submit a new generation task. |