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 共用，不使用团队积分。