| MCP server does not start |
Invalid JSON, missing Node/npm access, or a missing API key variable. |
Validate the JSON, confirm npx works in the client environment, and check the exact FREEBEAT_API_KEY name. |
| Generation request is rejected |
Prompt length or parameters do not meet the selected model’s constraints. |
Trim the prompt to 1–2,000 characters and compare duration, resolution, aspect ratio, and audio settings with get_model_help. |
| No video URL appears immediately |
Video generation is asynchronous; the initial response provides a batch identifier. |
Poll get_task_status using the batch ID as task_id, and inspect completed items. |
| Task status does not match expected casing |
An older backend may return uppercase status values. |
Normalize status strings when comparing them, and handle pending, completed, and failed states explicitly. |
| Completed response has no expected video field |
The wrong batch item may be selected, or the task may be image-related. |
Inspect the response’s task type and items; for video results, read video_url from the completed item. |