← 返回案例库

🎬 Seedance 视频生成 MCP 连接器

把字节 Seedance 视频生成模型通过非线智能 API 封装成 WorkBuddy 自定义 MCP 连接器,实现对话内一键生成视频。

AI 工具集成 MCP 连接器 视频生成 API 对接 Skill

业务痛点

解决方案(5 步人机协作)

  1. 接口探测验证 —— 用 curl 实测非线智能 OpenAI 兼容端点,确认创建用 POST /v1/videos(multipart/form-data)、查询用 GET /v1/videos/{id} 轮询到 succeeded。
  2. MCP Server 封装 —— 用 FastMCP 框架实现三个工具:submit_video(提交任务)、get_video(轮询取结果)、list_seedance_models(列可用模型)。
  3. 环境隔离 —— 独立 Python venv + fastmcp 3.4.7,避免与系统或其他项目依赖冲突。(踩坑:新版 mcp 把 FastMCP 拆成了独立包 fastmcp)
  4. 注册连接器 —— 写入 ~/.workbuddy/mcp.json 的 seedance-nonelinear 条目,WorkBuddy UI 点「信任」即启用。
  5. 端到端验证 —— 两条真实视频均 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?..."
  }
}

⚠️ 关键坑点

🎬 演示视频(试用)

提示词:「一只银色机器猫在阳光明媚的城市广场上行走,电影感运镜,暖色调」
模型:Doubao-Seedance-1.0-pro-fast | 1080p / 5s / 16:9 | 通过非线智能 API 生成

↑ 点击播放演示视频(若直链已失效请重新生成)

如何复用

该方案已封装为用户级 Skill,跨项目可用。在任何 WorkBuddy 对话中提到「用 Seedance 生成视频」「非线智能接 MCP」即可自动加载完整流程。

在 WorkBuddy 中使用 →