← 所有文章

Seedance 2.5 API 与 MCP：如何把视频生成接入你的项目

06.09.2026

Seedance 2.5 不仅可以通过 NeuralSpace 网页界面使用，还支持公开的 /v1 API 与模型上下文协议（MCP）服务器。开发者与 AI Agent 可以在代码中直接调用视频生成能力：发送文本提示词、传入参考图像和视频素材、控制生成时长，并通过链接获取生成结果。

API 如何工作

视频生成需要几分钟，所以 API 是异步的。首先发送 POST 请求创建任务——平台计算费用、立即扣除 token 并返回任务标识符。随后轮询任务状态，视频就绪后即可获取直链文件。出现错误或超时会自动退还 token。可在控制台的 API 密钥页面快速创建密钥。

API 端点

创建任务通过 POST /v1/videos/generations，请求体为 { model: "seedance-2.5", prompt, duration, resolution, aspect_ratio, image_urls, video_urls, audio_urls }。查询状态与结果通过 GET /v1/videos/generations/:id。完整模型列表及实时价格可查阅 API 文档或通过 GET /v1/models 获取。

通过 MCP（Model Context Protocol）接入

针对 Claude Desktop、Cursor、Cline 等各类 AI Agent，NeuralSpace 在 https://neuralspace.pro/mcp 提供了官方 MCP 服务端。Seedance 2.5 已在 generate_video 工具中得到原生支持，并可通过 check_video 轮询状态。Agent 只需传入 model: "seedance-2.5" 及相应提示词，即可在后台自动调用生成并从账户余额扣费。

{
  "mcpServers": {
    "neuralspace": {
      "url": "https://neuralspace.pro/mcp",
      "headers": {
        "x-api-key": "nsk-你的密钥"
      }
    }
  }
}

Seedance 2.5 功能特性

在公开 API 和 MCP 中，该模型统一使用标识符 seedance-2.5。支持 480p、720p 和 1080p 分辨率，4 至 30 秒时长选择，音频生成，多种画幅比（16:9、9:16、1:1、4:3、3:4、21:9 或自适应），以及参考图片与视频输入。接入前可在模型页面直观体验各参数效果。

cURL 请求示例

通过公开 API 创建视频生成任务：

curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "深色桌面上未来主义水晶的特写镜头，柔和霓虹光线，电影级运镜",
    "duration": 5,
    "resolution": "720p"
  }'

响应返回任务 id、pending 状态及轮询地址。查询生成进度：

curl https://neuralspace.pro/v1/videos/generations/TASK_ID \
  -H "x-api-key: nsk-你的密钥"

任务完成（completed）后，响应体中的 data[0].url 即为最终视频链接。

常见问题

Seedance 2.5 可以通过 API 和 MCP 使用吗？

是的，Seedance 2.5 全面支持公开 REST API（模型标识 seedance-2.5）与官方 MCP 服务端的 generate_video 工具。具体参数参见 API 文档。

如何获取 API key？

可在 NeuralSpace 控制台的 API 密钥页面立即生成。

通过 API 生成如何计费？

按秒计费，费率与网站一致，根据所选分辨率（480p、720p 或 1080p）计算。实时 token 单价可通过 GET /v1/models 查询并在 /v1/docs 显示。