← 返回案例库
🎬 Seedance 视频生成 MCP 连接器
把字节 Seedance 视频生成模型通过非线智能 API 封装成 WorkBuddy 自定义 MCP 连接器,实现对话内一键生成视频。
AI 工具集成
MCP 连接器
视频生成
API 对接
Skill
业务痛点
- 接入门槛高:Seedance 官方 API 仅开放火山引擎方舟,需企业认证、单独开通,个人开发者难以直接使用。
- 文档不完善:非线智能作为聚合代理平台,Seedance 的接口文档缺失,端点形态需自行探测验证(试了 6 轮才定位到正确路径)。
- 异步任务复杂:视频生成不是一次调用返回结果——需要「提交 → 轮询 → 取回」三步异步流程,不像文本接口那样简单。
- 模型行为差异:fast 模型会强制输出 1080p,忽略你传的分辨率参数,这些坑点没有文档说明。
解决方案(5 步人机协作)
- 接口探测验证 —— 用 curl 实测非线智能 OpenAI 兼容端点,确认创建用 POST /v1/videos(multipart/form-data)、查询用 GET /v1/videos/{id} 轮询到 succeeded。
- MCP Server 封装 —— 用 FastMCP 框架实现三个工具:submit_video(提交任务)、get_video(轮询取结果)、list_seedance_models(列可用模型)。
- 环境隔离 —— 独立 Python venv + fastmcp 3.4.7,避免与系统或其他项目依赖冲突。(踩坑:新版 mcp 把 FastMCP 拆成了独立包 fastmcp)
- 注册连接器 —— 写入 ~/.workbuddy/mcp.json 的 seedance-nonelinear 条目,WorkBuddy UI 点「信任」即启用。
- 端到端验证 —— 两条真实视频均 succeeded 并拿到 .mp4 直链,封装为可复用用户级 Skill。
关键成果
接口探测 6 轮定位
MCP Server 3 个工具
演示视频 1080p 验证通过
封装为可复用 Skill
所用 AI 能力 / Skill / 工具
🔧 seedance-MCP(自定义 MCP 连接器)
⚡ fastmcp 3.4.7(MCP Server 框架)
🐍 Python urllib(HTTP / multipart)
🔌 WorkBuddy 自定义连接器(mcp.json)
☁️ 非线智能 API(nonelinear.com)
🎬 字节 Seedance(Doubao-Seedance-1.0-pro-fast)
接口契约(实测得出,非文档假设)
# 创建视频(multipart/form-data)
POST https://api.nonelinear.com/v1/videos
Authorization: Bearer sk-xxx
Content-Type: multipart/form-data
model=Doubao-Seedance-1.0-pro-fast
prompt=一只银色机器猫在阳光明媚的城市广场上行走
duration=5
ratio=16:9
resolution=720p
# 返回 {"id": "Doubao-Seedance-1.0-pro-fast----cgt-20260811xxxxx"}
# 查询状态(轮询直到 status=succeeded)
GET https://api.nonelinear.com/v1/videos/{id}
# 成功返回:
{
"status": "succeeded",
"content": {
"video_url": "https://ark-content...xxx.mp4?..."
}
}
⚠️ 关键坑点
- fast 模型强制 1080p:传 resolution=480p/720p 都被忽略,实际出片固定 1080p。要控分辨率需换 1.5-pro 或 1.0-pro 模型。
- 正确路径是 /v1/videos:/v1/videos/generations 返回 405 Method Not Allowed(被误当 ID 查询),不要用这个路径。
- 必须用 multipart:POST body 是 multipart/form-data 不是 JSON,否则返回 415 Unsupported Media Type。
- FastMCP 已拆包:mcp >= 1.x 后 FastMCP 不在 mcp.server.fastmcp,而是独立包 fastmcp,导入用 from fastmcp import FastMCP。
- 视频直链 24 小时失效:拿到后建议尽快下载保存。
🎬 演示视频(试用)
提示词:「一只银色机器猫在阳光明媚的城市广场上行走,电影感运镜,暖色调」
模型:Doubao-Seedance-1.0-pro-fast | 1080p / 5s / 16:9 | 通过非线智能 API 生成
↑ 点击播放演示视频(若直链已失效请重新生成)
如何复用
该方案已封装为用户级 Skill,跨项目可用。在任何 WorkBuddy 对话中提到「用 Seedance 生成视频」「非线智能接 MCP」即可自动加载完整流程。
在 WorkBuddy 中使用 →