# RunningHub 视频连接器 · RunningHub Video Connector

> 开发者：**AI芳程式** ｜ 问题反馈或建议：**zzdh518**
> Developer: **AI芳程式 (AI Fangchengshi)** ｜ Feedback & suggestions: **zzdh518**

文生视频 · 图生视频 · 首尾帧 · 参考生视频 · 视频增强 · 数字人，200+ 视频模型 API

Text/image-to-video · start-end frames · reference-to-video · enhancement · digital human — 200+ video model APIs

🎬 **品类 / Category：视频 · 200+ 视频模型** ｜ 形态 / Form：WorkBuddy 连接器包（MCP + Skill）**＋ 自带 `server/` 源码，可完全独立部署**

面向 **[WorkBuddy](https://www.workbuddy.cn) 连接器市场**的成品提交包（MCP + Skill 方案），同时适用于任意支持 MCP 的客户端。底层 MCP 服务器来自 [runninghub-mcp](https://github.com/fancy5166/runninghub-mcp)，通过 `--scope video` 限定能力范围。

A ready-to-submit **[WorkBuddy](https://www.workbuddy.cn)** connector package (MCP + Skill). The underlying MCP server is [runninghub-mcp](https://github.com/fancy5166/runninghub-mcp), restricted to `--scope video`.

> **30 秒判断要不要用**：一条片子要试好几个平台，可灵排队、首尾帧不会调、数字人口播又得另找工具，流程被切成好几段 —— 这个仓库就是为它准备的。
> **30-second check** (EN): Stop juggling five platforms for one clip; start-end frames and digital humans included.
> 下面是它的完整定位、能解决的问题，以及家族里另外 5 个仓库。Below: what this repo is, what it solves, and the other five repos in the family.


## 🧭 本仓库在家族里的位置 / Where this repo fits

| | |
| --- | --- |
| **本仓库 / This repo** | 🎬 **runninghub-video-connector** — 视频连接器 |
| **品类 / Category** | 视频 · 200+ 视频模型 |
| **形态 / Form** | WorkBuddy 连接器包（MCP + Skill）**＋ 自带 server 源码，可完全独立部署** |
| **独立可用 / Standalone** | ✅ 不需要任何其它仓库，克隆本仓库即可跑起来 |
| **联动可用 / Interop** | ✅ 与家族其它 5 个仓库共用同一套 RunningHub 账号与 API Key，可任选组合安装 |
| **适合谁 / Who it's for** | 短视频运营 / 广告投放 / 短剧漫剧团队 / 数字人直播 |
| **解决的痛点 / Pain it kills** | 一条片子要试好几个平台，可灵排队、首尾帧不会调、数字人口播又得另找工具，流程被切成好几段。 |
| **给你的价值 / What you get** | 200+ 视频模型（可灵 / 海螺 / Seedance / Vidu / 万相）统一入口：文生视频、图生视频、首尾帧、参考生视频、视频增强、数字人口播一条龙。 |

### 🚀 两种用法 / Two ways to use it

**A. 只装这一个（独立部署，最小依赖）** — 你只想在这一个品类上用 AI：

- **WorkBuddy 用户**：在连接器市场搜「RunningHub」，装这一个就行（见下方「安装」）。
- **任意 MCP 客户端 / 开发者**：克隆本仓库即可**完全本地运行**，不依赖任何已发布的 npm 包：

```bash
git clone https://github.com/fancy5166/runninghub-video-connector.git && cd runninghub-video-connector
npm install
node server/cli.js --scope video
```

> `--scope` 让后端只加载本品类模型：启动更快、上下文更省、也更不容易挑错模型。

**B. 家族联动（图 + 视频 + 音频一次到位）** — 你想让 AI 一次干完整条链路：

同一个 API Key 下装多个连接器，或在 WorkBuddy 里直接装**全能连接器** [runninghub-connector](https://github.com/fancy5166/runninghub-connector)——一个顶四个；开发者还可以直接用核心引擎 [runninghub-mcp](https://github.com/fancy5166/runninghub-mcp) 自己拼。

### 🔗 家族全部仓库 / The whole family

| | 仓库 / Repo | 品类 / Category | 一句话 / In one line |
| --- | --- | --- | --- |
| 🏠 | **[runninghub-workbuddy-connectors](https://github.com/fancy5166/runninghub-workbuddy-connectors)** | 家族总入口 · 源码真源 | 6 个包的源码 + 4 个可直接上传 WorkBuddy 的连接器 zip，一次拿全 |
| ⚙️ | **[runninghub-mcp](https://github.com/fancy5166/runninghub-mcp)** | 核心引擎 · MCP 服务器（npm 包，非连接器） | 给任何 MCP 客户端装上 RunningHub 的 350+ 模型双手 |
| 🧰 | **[runninghub-connector](https://github.com/fancy5166/runninghub-connector)** | 全能 · 图 + 视 + 音 + 3D + 工作流 + LLM | 一个连接器顶掉一堆账号：350+ 模型，一句话从出图切到出片再切到配音 |
| 🎨 | **[runninghub-image-connector](https://github.com/fancy5166/runninghub-image-connector)** | 图像 · 90+ 图像模型 | 电商主图、模特换背景、老图 4K 放大，中文提示词直接可用 |
| 🔊 | **[runninghub-audio-connector](https://github.com/fancy5166/runninghub-audio-connector)** | 音频 · 50+ 音频模型 | 配音、配乐、人声分离一站搞定，不用买音色包 |

> 💡 **不确定装哪个？** 先装全能连接器 [runninghub-connector](https://github.com/fancy5166/runninghub-connector) 一个就够；
> 只做图片就装 [runninghub-image-connector](https://github.com/fancy5166/runninghub-image-connector)，
> 只做视频装 [runninghub-video-connector](https://github.com/fancy5166/runninghub-video-connector)，
> 只做配音/音乐装 [runninghub-audio-connector](https://github.com/fancy5166/runninghub-audio-connector)，
> 要自己二次开发从 [runninghub-mcp](https://github.com/fancy5166/runninghub-mcp) 入手。

> 全部由 **AI芳程式** 开发，问题反馈或建议请联系 **zzdh518**。


## 🐣 保姆级小白指南 / Beginner's guides

- 中文：[GUIDE.md](GUIDE.md) — 完全没用过 AI 产品也能照着用起来
- English: [GUIDE_EN.md](GUIDE_EN.md) — step-by-step for absolute beginners

## 前置条件 / Prerequisites

1. **API Key** — 在 [RunningHub API 管理页面](https://www.runninghub.cn/enterprise-api/consumerApi) 点「**新建**」创建
2. **账户余额** — 用邀请码注册即送 **500 RH 币**（可免费生成不少图片和视频）；用完后到 [RunningHub 官网](https://www.runninghub.cn) 充值
3. 还没有账号？[**RunningHub 邀请注册链接**](https://www.runninghub.cn?inviteCode=zlhtnu0f) —— **填写邀请码 `zlhtnu0f`，可得 500 RH 币，可以免费生成不少图片和视频哦！**

## 安装 / Install

**WorkBuddy 连接器市场**：搜索「视频连接器」安装，连接时粘贴 API Key。

**手动配置 / Manual MCP config**：

```json
{
  "mcpServers": {
    "runninghub-video": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "runninghub-mcp@latest", "--scope", "video"],
      "env": { "RUNNINGHUB_API_KEY": "你的 API Key / your API key" }
    }
  }
}
```

**一键安装 / One-click install**：把 [INSTALL_PROMPT.md](INSTALL_PROMPT.md) 里的提示词复制给你的 AI Agent，它会自动安装并引导配置。Copy the prompt from [INSTALL_PROMPT.md](INSTALL_PROMPT.md) into your agent.

## 能做什么 / What you can ask

- 「用可灵文生视频生成一段海浪拍岸的 5 秒视频」
- 「把这张人物图用图生视频动起来」
- 「用数字人口播模型生成一段说话视频」

- "Generate a 5s ocean wave video with Kling"
- "Animate this portrait into a short video"
- "Create a talking-head video with the digital human model"

## 工具 / Tools

7 个工具（模型检索 / 提交 / 等待 / 上传下载），详见 [skills/video-usage/SKILL.md](skills/) 与 [runninghub-mcp 工具表](https://github.com/fancy5166/runninghub-mcp#工具--tools)。

## 仓库结构 / Repo layout

```
├── connector-meta.json    # WorkBuddy 连接器元信息（中英名称/描述/示例）
├── mcp.json               # MCP 服务器连接配置
├── token-schema.json      # 用户自填 Token 表单（API Key）
├── icon.svg               # 市场图标（芳字主视觉 + AI芳程式 署名）
├── GUIDE.md / GUIDE_EN.md # 保姆级小白指南（中/英）
├── skills/                # AI 使用说明（SKILL.md）
├── server/                # ★ 内置 MCP 服务器源码（本仓库独立可跑，不依赖任何已发布包）
├── data/catalog.json      # ★ 内置模型目录（本仓库独立可跑）
├── package.json           # ★ 独立包定义（npm start → node server/cli.js --scope video）
├── tools/pack.mjs         # 打包成可上传的 zip（自动排除 server/ data/ 等独立包文件）
└── .github/workflows/     # 打 tag 自动打包发布
```

> ★ 标记的文件是本仓库「独立部署」能力的来源：克隆下来 `npm install && npm start` 即可作为独立 MCP 服务器运行，
> 不依赖 npm 上是否已发布 `runninghub-mcp`。打 WorkBuddy 连接器 zip 时这些文件会被自动排除，包体保持精简。
>
> ★ marked files make this repo **standalone**: `npm install && npm start` runs it as its own MCP server without
> relying on any published npm package. They are excluded from the WorkBuddy connector zip.

## 打包提交 / Package & submit

```bash
node tools/pack.mjs        # 生成 dist/runninghub-video-<version>.zip
```

把 zip 上传到 WorkBuddy 开发者后台审核即可。Upload the zip to the WorkBuddy developer backend.

## 许可证 / License

[MIT](LICENSE) © AI芳程式