MCP

在 AI 助理中生成影片與圖像

透過模型上下文協定(MCP)將您的 Seedance 2.0 AI 帳戶連接至 AI 助理。在對話中描述需求後,助理會先告知所需點數,經您確認再提交生成,並回傳生成結果。

MCP 伺服器網址

https://preview.seedance2ai.io/api/mcp

使用流程

  1. 1

    新增伺服器網址

    在 AI 助理的連接器或 MCP 設定中新增上方的 MCP 伺服器網址。

  2. 2

    登入並授權

    登入您的 Seedance 2.0 AI 帳戶並允許存取,無需 API 金鑰。

  3. 3

    描述您的需求

    在對話中提出影片或圖像需求。助理在生成前會先確認所需點數。

各用戶端連線步驟

不同版本用戶端的選單名稱可能略有差異。

Claude(網頁版與桌面版)

免費版最多可新增一個自訂連接器。Team 與 Enterprise 方案需由擁有者先在「組織設定」(Organization settings)>「連接器」(Connectors)中新增。

  1. 開啟「自訂」(Customize)>「連接器」(Connectors),點選「+ 新增」(+ Add),選擇「新增自訂連接器」(Add custom connector)。
  2. 填寫名稱(例如 Seedance 2.0 AI),貼上 MCP 伺服器網址,然後點選「新增」(Add)。
  3. 點選「連線」,登入您的 Seedance 2.0 AI 帳戶並允許存取。
  4. 在對話中點選左下角的「+」,開啟「連接器」(Connectors)並啟用該連接器。

ChatGPT

能否新增自訂 MCP 伺服器,取決於您的帳戶及工作區政策。

  1. 開啟「外掛程式」(Plugins)頁面(chatgpt.com/plugins),點選「+」,選擇「新增自訂 MCP 伺服器」(Add custom MCP server)。
  2. 填寫名稱與說明,在「連線」(Connection)中貼上 MCP 伺服器網址,驗證方式選擇 OAuth。
  3. 閱讀風險提示後,點選「建立為外掛程式」(Create as a plugin),接著登入您的 Seedance 2.0 AI 帳戶並允許存取。
  4. 在對話中輸入 @ 並選擇該外掛程式,然後提出需求。

Gemini

自訂應用程式需具備 Gemini Spark 使用權限,年滿 18 歲、位於美國,並開啟「活動記錄」(Keep Activity)。Google 目前僅在英文環境下提供此功能。

  1. 開啟「設定」,進入「已連結的應用程式」(Connected Apps)。部分版本中,此入口位於「個人化智慧服務」內。
  2. 在「適用於 Spark 的自訂應用程式」中貼上 MCP 伺服器網址,然後點選「下一步」。
  3. 登入您的 Seedance 2.0 AI 帳戶並允許存取。
  4. 切換至 Spark,輸入 @ 並選擇該應用程式,然後提出需求。

Claude Code

  1. 在終端機中執行以下指令以新增伺服器。
  2. 在 Claude Code 中執行 /mcp,選擇 seedance2ai 並完成登入。
claude mcp add --transport http seedance2ai https://preview.seedance2ai.io/api/mcp

Codex

  1. 執行第一條指令以新增伺服器。
  2. 執行第二條指令以登入並允許存取。
codex mcp add seedance2ai --url https://preview.seedance2ai.io/api/mcp
codex mcp login seedance2ai

其他用戶端(API 金鑰)

  1. 僅在用戶端不支援 OAuth 登入時使用此方式。
  2. 在 API 頁面建立 API 金鑰,並將其作為 Bearer 權杖與 MCP 伺服器網址一同提供給用戶端。
  3. 請將金鑰儲存在用戶端的安全憑證設定中,切勿貼至對話內容。
https://preview.seedance2ai.io/api/mcp
Authorization: Bearer sk_live_…

由程式設計助理完成設定

將以下指示傳送給 Claude Code 或 Codex,助理會讀取設定說明並為您新增伺服器。

Read https://preview.seedance2ai.io/mcp-guide.txt and connect the Seedance 2.0 AI MCP server (https://preview.seedance2ai.io/api/mcp) to this client.

支援的模型

各模型的可選參數與網站及 API 保持一致。

  • Seedance 2.5
    影片
    支援文字、圖像或參考素材生成影片;長度 4 至 30 秒,最高 2K,可生成音訊。需有購買紀錄。
  • Seedance 2.0
    影片
    支援文字、圖像或參考素材生成影片;長度 4 至 15 秒,提供 Mini、Fast 與 Pro 三個品質等級。
  • GPT Image 2.5
    圖像
    支援文字生成圖像與圖像編輯。
  • GPT Image 2
    圖像
    支援文字生成圖像與圖像編輯,單次請求最多生成四張圖像。
  • Nano Banana Pro
    圖像
    支援文字生成圖像與圖像編輯,最高 4K。
  • Nano Banana 2
    圖像
    支援文字生成圖像與圖像編輯,最高 4K,可選擇參考搜尋結果生成。
  • Nano Banana 2 Lite
    圖像
    支援文字生成圖像與圖像編輯,固定 1K,費用最低。

點數與計費

  • 連線、查詢餘額、取得報價及查詢任務狀態均不消耗點數。
  • 僅在提交生成時扣除點數,所用餘額與網站及 API 為同一個人餘額。
  • 生成失敗的任務將自動退還點數。
  • 影片長度設為自動時,將按最長長度預扣點數,生成完成後退還未使用的部分。
  • AI 助理的訂閱費用與 Seedance 2.0 AI 點數分別計費。

範例指令

連線完成後,可將以下指令傳送給 AI 助理。

  • 我可以透過 Seedance 2.0 AI 使用哪些影片與圖像模型?我目前有多少點數?
  • 請為一段 5 秒、16:9 的 Seedance 2.0 Fast 等級影片報價:黃昏時分,一艘紙船沿著雨後的街道漂流。
  • 使用 Nano Banana Pro 為一場山地音樂節製作一張 2K 方形海報,生成前請先告知所需點數。
  • 將這張風景照片製作成 6 秒的 Seedance 2.5 影片,畫面中雲層緩緩飄動:https://example.com/landscape.jpg
  • 查詢我最近一個任務的狀態,完成後請傳送結果連結。

常見問題

連線成功後無法使用工具,應如何處理?

請確認已完成登入,並已在目前對話中啟用該連接器:Claude 透過「+」>「連接器」(Connectors)啟用,ChatGPT 透過輸入 @ 選擇外掛程式。如仍未顯示工具,請建立新對話或重新連線。

是否需要 API 金鑰?

支援 OAuth 登入的用戶端無需 API 金鑰,例如 Claude、ChatGPT、Gemini、Claude Code 與 Codex。僅不支援 OAuth 的用戶端需要使用 API 金鑰。

如何中斷 AI 助理的連線?

在 API 頁面的「已連接的 AI 應用」中,點選對應應用程式旁的「中斷連接」,存取權限將立即失效。如需再次使用,請重新連線並允許存取,該應用程式將以新連線顯示。

重新連線後,任務清單中為何不顯示先前的任務?

每個連線僅列出由其建立的任務。先前連線建立的任務仍會顯示在 API 頁面的「最近的 API 任務」中。

能否使用儲存在本機電腦中的圖像或影片?

參考檔案須可透過公開的 HTTPS 網址存取。請先將檔案上傳至可提供直接連結的服務,再於指令中附上該連結。

使用的是哪部分點數?

使用您的個人點數餘額,與網站及 API 共用,不使用團隊點數。

立即連線

複製 MCP 伺服器網址並新增至 AI 助理。您可隨時在 API 頁面管理已連線的應用程式。

前往 API 頁面