← 所有文章

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

发光的胶片，抽象运动画面从中飞出

Seedance 是视频生成模型。NeuralSpace 提供以下模型：Seedance 2.0。它们都通过同一个公开 API 运行，并为 AI 智能体提供了现成的 MCP 服务器。密钥在 API 密钥页面 签发。本文介绍它的能力、请求示例和接入方法。

Seedance 能做什么

Seedance 2.0 根据文本描述生成视频。生成是异步的：POST 创建任务并返回 id，然后通过 GET /v1/videos/generations/:id 轮询状态直到完成。提供 fast 或 standard 速度以及 720p 和 1080p 分辨率，按秒计费。

API 端点

请求发送到 POST /v1/videos/generations。示例：{"model": "seedance-2.0", "prompt": "深色桌面上的商品特写", "duration": 5, "resolution": "720p"}。授权使用请求头 x-api-key 中的 API key。可用的模型 id：seedance-2.0。

发光的胶片与抽象运动画面

MCP 工具

NeuralSpace 的 MCP 服务器位于 POST /mcp（Streamable HTTP）。要使用 Seedance，智能体调用工具：generate_video, check_video, list_models, get_balance。这让 Claude Code、Cursor 等 MCP 客户端能直接使用网站模型。

如何接入

在 NeuralSpace 注册，打开 API 密钥页面 并创建 nsk-… 格式的密钥。然后在请求头或 MCP 客户端设置中传入它。完整文档见 /v1/docs 页面。

常见问题

生成是同步还是异步？

异步：POST 创建任务，然后通过 GET /v1/videos/generations/:id 轮询状态。

有哪些分辨率？

720p 和 1080p，速度 fast 或 standard。

请求是什么格式？

POST /v1/videos/generations，带 model、prompt、duration 和 resolution 字段。