# RunningHub 图像连接器 · RunningHub Image Connector

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

文生图 · 图生图 · 图像编辑 · 放大修复，90+ 图像模型 API

Text-to-image · image-to-image · editing · upscaling — 90+ image model APIs

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

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

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 image`.

> **30 秒判断要不要用**：主图详情页要量产、模特图要换背景、老图要放大；排队久、中文提示词水土不服、出图不可控 —— 这个仓库就是为它准备的。
> **30-second check** (EN): Product hero shots, background swaps and 4K upscaling — Chinese prompts work as-is.
> 下面是它的完整定位、能解决的问题，以及家族里另外 5 个仓库。Below: what this repo is, what it solves, and the other five repos in the family.


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

| | |
| --- | --- |
| **本仓库 / This repo** | 🎨 **runninghub-image-connector** — 图像连接器 |
| **品类 / Category** | 图像 · 90+ 图像模型 |
| **形态 / Form** | WorkBuddy 连接器包（MCP + Skill）**＋ 自带 server 源码，可完全独立部署** |
| **独立可用 / Standalone** | ✅ 不需要任何其它仓库，克隆本仓库即可跑起来 |
| **联动可用 / Interop** | ✅ 与家族其它 5 个仓库共用同一套 RunningHub 账号与 API Key，可任选组合安装 |
| **适合谁 / Who it's for** | 电商设计 / 社媒运营 / 插画师 / 品牌视觉 |
| **解决的痛点 / Pain it kills** | 主图详情页要量产、模特图要换背景、老图要放大；排队久、中文提示词水土不服、出图不可控。 |
| **给你的价值 / What you get** | 90+ 图像模型（Seedream / 千问 / 悠船 / Topaz）随选随切，文生图、图生图、精修、4K 放大全在一个对话里，中文提示词原样可用。 |

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

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

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

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

> `--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-video-connector](https://github.com/fancy5166/runninghub-video-connector)** | 视频 · 200+ 视频模型 | 一条片子不用换五个平台，首尾帧与数字人口播全覆盖 |
| 🔊 | **[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-image": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "runninghub-mcp@latest", "--scope", "image"],
      "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

- 「用 seedream 文生图画一张赛博朋克城市夜景」
- 「把这张照片放大到 4K」
- 「用千问图像编辑，把图片背景换成海边」

- "Generate a cyberpunk city night scene with seedream"
- "Upscale this photo to 4K"
- "Change the background to a beach with Qwen image edit"

## 工具 / Tools

7 个工具（模型检索 / 提交 / 等待 / 上传下载），详见 [skills/image-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 image）
├── 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-image-<version>.zip
```

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

## 许可证 / License

[MIT](LICENSE) © AI芳程式