CLI

Seedance CLI：在終端機與 AI 應用程式中生成影片與圖像

Seedance CLI 可在終端機中使用，也可在 Claude Code、Codex、Cursor、OpenCode 等能執行指令的 AI 應用程式中使用。它與網站共用點數、價格相同，並可使用您電腦中的檔案作為參考素材。

適合使用 Claude Code、Codex、Cursor、OpenCode 等電腦上 AI 應用程式的使用者。如果您使用網頁版或手機 App 的 Claude、ChatGPT，請改用 MCP。 查看 MCP 使用方式

使用流程

  1. 1

    複製指令，傳送給 AI 應用程式

    在 Claude Code、Codex、Cursor、OpenCode 等 AI 應用程式中貼上以下指令，應用程式會自動安裝 CLI。

    複製以下指令，傳送給您使用的 AI 應用程式

    Read https://www.seedance2ai.io/mcp-guide.txt and set up the Seedance2 CLI on this computer. Let me sign in in my browser, and show me the credit cost before generating.
  2. 2

    登入並授權

    應用程式會開啟瀏覽器，請登入您的 Seedance 2.0 AI 帳戶並允許存取。

  3. 3

    說出您想生成的內容

    例如「幫我生成一段 5 秒的影片：紙船在雨夜的街道上漂流」，或「生成一張橘貓看雨的圖片」。應用程式會先告知所需點數再生成（費用較高時會先徵得您的同意），並將影片或圖片儲存到應用程式目前的資料夾（也可以讓應用程式儲存到其他位置）。生成紀錄也會出現在網站的創作歷史中。

實際執行效果

用一句話提出需求，AI 應用程式代為執行指令。以下輸出來自一次實際執行；等待過程已縮短，本次生成實際耗時約兩分鐘。

result.mp4
result.mp4：由以上指令生成的影片。

自行設定

  1. 1

    安裝 CLI

    執行第一條指令安裝 CLI。需要 macOS 或 Linux 上的 Node.js 22 或更新版本；Windows 使用者請使用 WSL。

    npm install -g @seedance2ai/cli
  2. 2

    瀏覽器登入並授權

    執行第二條指令，然後在自動開啟的瀏覽器視窗中登入並允許存取。

    seedance2 auth login
  3. 3

    查看點數餘額

    執行第三條指令查看點數餘額。

    seedance2 account

生成

設定完成後，直接告訴 AI 應用程式您想生成什麼即可。如需手動生成，請依照以下步驟操作：

  1. 1

    撰寫請求

    新增 request.json 檔案，依下方範例填寫模型及其參數。圖片和影片欄位也可填寫您電腦中的檔案。

    request.json

    {"model":"seedance2","quality_tier":"fast","prompt":"A paper boat drifting down a rainy street at night","duration":"5","resolution":"720p"}
  2. 2

    查詢價格

    執行此指令查詢所需點數，查詢價格不扣點數。

    seedance2 estimate --input request.json
  3. 3

    開始生成

    將 CREDITS 替換為上一步查詢到的價格，超出該價格的生成不會送出。指令會等待生成完成，並傳回任務 ID。

    seedance2 create --input request.json --max-credits CREDITS --wait
  4. 4

    下載結果

    將 TASK_ID 替換為上一步傳回的任務 ID。

    seedance2 download TASK_ID --output result.mp4

執行 seedance2 --help 查看全部指令。

支援的模型

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

  • Seedance 2.5
    影片
    支援文字、圖像或參考素材生成影片；長度 4 至 30 秒，最高 2K，可生成音訊。需有購買紀錄。
  • Seedance 2.0
    影片
    支援文字、圖像或參考素材生成影片；長度 4 至 15 秒，提供 Mini、Fast 與 Pro 三個品質等級。
  • Kling 4.0
    影片
    支援文字、參考素材或關鍵影格生成影片；長度 3 至 30 秒，720p 或 1080p。
  • GPT Image 2.5
    圖像
    支援文字生成圖像與圖像編輯。
  • GPT Image 2
    圖像
    支援文字生成圖像與圖像編輯，單次請求最多生成四張圖像。
  • Nano Banana Pro
    圖像
    支援文字生成圖像與圖像編輯，最高 4K。
  • Nano Banana 2
    圖像
    支援文字生成圖像與圖像編輯，最高 4K，可選用網路搜尋增強。
  • Nano Banana 2 Lite
    圖像
    支援文字生成圖像與圖像編輯，固定 1K，費用最低。
  • Seedream 5 Pro
    圖像
    支援文字生成圖像與圖像編輯，可輸出 1K 或 2K。
  • Seedream 5 Lite
    圖像
    支援文字生成圖像與圖像編輯，可輸出 2K 或 4K。

點數與計費

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

常見問題

哪些 AI 應用程式可以使用 Seedance CLI？

所有能在您電腦上執行指令的 AI 應用程式皆可使用。終端機類：Claude Code、Codex、Gemini CLI、OpenCode 和 Qwen Code；程式碼編輯器：Cursor、Windsurf、Trae 和 Kiro；編輯器擴充功能：GitHub Copilot（Agent 模式）、Cline 和 Roo Code。網頁版或手機 App 中的 Claude、ChatGPT、Gemini 等聊天應用程式無法執行指令，請改用 MCP。CLI 需要 Node.js 22 或更新版本，支援 macOS 和 Linux，Windows 請使用 WSL。

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

可以，但僅限在您電腦上執行的 AI 應用程式，例如 Claude Code、Codex、Cursor 和 OpenCode，應用程式會在生成前替您上傳檔案。Claude、ChatGPT、Gemini 等聊天應用程式無法存取您電腦中的檔案，使用這類應用程式時，參考檔案須可透過公開的 HTTPS 網址存取。請先將檔案上傳至可提供直接連結的服務，再於指令中附上該連結。

使用的是哪部分點數？

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