freebeat MCP
freebeat 是最大的音樂影片生成器,它的 MCP 伺服器讓 AI Agent 可以直接使用:任何歌曲都能生成音樂影片、歌詞影片和舞蹈影片,還支援寫歌、照片唱歌、對嘴、圖片和影片片段。
- 伺服器網址:
https://freebeat.ai/api/mcp(遠端,Streamable HTTP) - 登入: 使用你的 freebeat 帳號透過 OAuth 登入,不需要 API 金鑰。
- 適用於: ChatGPT、Codex、Claude、Claude Code、Cursor,以及任何透過 OAuth 連接遠端 MCP 伺服器的 Agent。
連接
ChatGPT
- Settings → Apps → Advanced settings → 開啟 Developer mode。
- Plugins → Browse directory → Add → Add custom MCP server。名稱填
freebeat,URL 填https://freebeat.ai/api/mcp,驗證方式選 OAuth,然後點擊 Connect。 - 登入 freebeat 並點擊 Allow。
Codex(CLI、IDE 擴充功能和應用程式)
codex mcp add freebeat --url https://freebeat.ai/api/mcp
codex mcp login freebeatClaude(網頁版和桌面版)
- Customize → Connectors → Add → Add custom connector。
- 名稱填
freebeat,URL 填https://freebeat.ai/api/mcp,然後點擊 Add 和 Connect。 - 登入 freebeat 並點擊 Allow。
Claude Code
claude mcp add --transport http freebeat https://freebeat.ai/api/mcp接著在 Claude Code 中執行 /mcp,選擇 freebeat 並登入。
Cursor
將 freebeat 加入 Cursor,或把下面的內容放進 ~/.cursor/mcp.json,再到 Cursor 的 MCP 設定中點擊 Connect:
{
"mcpServers": {
"freebeat": { "url": "https://freebeat.ai/api/mcp" }
}
}其他 Agent
新增一個遠端 MCP 伺服器,URL 為 https://freebeat.ai/api/mcp。伺服器公開了它的 OAuth 中繼資料(/.well-known/oauth-protected-resource/api/mcp 和 /.well-known/oauth-authorization-server),並支援搭配 PKCE 的動態用戶端註冊,因此任何遵循 MCP 授權規範的用戶端都可以登入。
點數
生成影片和其他內容會消耗你的 freebeat 點數;新帳號贈送 500 點。你的 Agent 在花費前會先問你:每個付費工具都需要 max_credits(你允許它花費的上限),無法事先報出總價時則需要 accept_unknown_cost。音樂影片、歌詞影片和舞蹈影片按階段分步計費,總價無法事先得知,因此需要 accept_unknown_cost。get_credit_balance 顯示你的餘額,quote_generation 為可報價的工具給出價格。
工具
音樂影片、歌詞影片和舞蹈影片
| 工具 | 功能 |
|---|---|
generate_music_video | 依歌曲節奏剪輯的多場景音樂影片。可選擇上傳照片(最多 5 張),讓你的藝人或角色入鏡。720p 或 1080p。 |
generate_lyric_video | 與人聲同步的動態歌詞,768p 或 2K。 |
generate_dance_video | 照片裡的人隨歌曲起舞(9:16 或 3:4,720p)。 |
get_video_session | 正在生成的影片的導演訊息、階段和媒體。 |
send_video_agent_message | 把你的意見傳給導演,或把工作階段切換為自動。 |
三個影片工具都需要一首歌(來自 upload_audio 或 generate_music 的 music_id),還可以附上提示詞和照片,以及 auto_mode:true 讓導演全權決定,false 則讓它在每個階段暫停,等你給意見(共創)。預設使用歌曲的前 15 秒;想用其他片段,請設定 start_ms 和 end_ms,上限取決於你的帳號。一支影片通常需要 15 到 60 分鐘,在 freebeat 的伺服器上執行;結果包含影片連結及其在 freebeat.ai 上的頁面。
音樂
| 工具 | 功能 |
|---|---|
list_music_models | 你可以使用的音樂模型。 |
generate_music | 根據提示詞生成原創歌曲,如果你提供歌詞就用你的歌詞。 |
唱歌和對嘴
| 工具 | 功能 |
|---|---|
generate_singing_video | 讓一張照片、一隻寵物或兩個人(二重唱)唱一首曲目。 |
generate_lip_sync_video | 讓現有的影片片段與音訊對嘴。 |
圖片、影片片段和文字
| 工具 | 功能 |
|---|---|
list_models, get_model_help | 可用的圖片和影片模型,以及各自的用法。 |
generate_image, edit_image | 建立或編輯圖片。 |
generate_video | 不帶歌曲的影片片段(文字生成影片或圖片生成影片)。 |
generate_text | 來自語言模型的文字。 |
list_effects, generate_effect | 用一首歌和一張圖片生成特效範本影片。 |
輸入、進度和點數
| 工具 | 功能 |
|---|---|
upload_audio | 來自附件檔案、HTTPS 音訊連結,或 SoundCloud、YouTube、Suno、Udio、TikTok、Stable Audio、Riffusion 頁面的歌曲。回傳 music_id。 |
upload_image, upload_video | 參考圖片和影片片段。 |
get_task_status, get_task_result | 任務的進度和最終結果。 |
get_credit_balance, quote_generation | 你的餘額和一次生成的價格。 |
中斷連接
在你的 Agent 的連接器或 MCP 設定中移除 freebeat。中斷連接會撤銷該連線對你帳號的存取權限。