Skip to Content
MCP Documentation

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

  1. Settings → Apps → Advanced settings → 開啟 Developer mode。
  2. Plugins → Browse directory → Add → Add custom MCP server。名稱填 freebeat,URL 填 https://freebeat.ai/api/mcp,驗證方式選 OAuth,然後點擊 Connect。
  3. 登入 freebeat 並點擊 Allow。

Codex(CLI、IDE 擴充功能和應用程式)

codex mcp add freebeat --url https://freebeat.ai/api/mcp codex mcp login freebeat

Claude(網頁版和桌面版)

  1. Customize → Connectors → Add → Add custom connector。
  2. 名稱填 freebeat,URL 填 https://freebeat.ai/api/mcp,然後點擊 Add 和 Connect。
  3. 登入 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。中斷連接會撤銷該連線對你帳號的存取權限。

Last updated on