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 页面