n8n 集成

MuAPI 提供官方 n8n 社区节点包，将完整的 MuAPI 模型目录直接带入你的 n8n 自动化工作流。无需编写一行代码，即可生成图像、视频和音频，或上传媒体素材。

包用途
n8n-nodes-muapi完整套件 — 通过 2 个节点覆盖 7 个类别的 60 多种 MuAPI 模型

安装

通过 n8n 社区节点（推荐）

  1. 打开 n8n → Settings → Community Nodes
  2. 点击 Install
  3. 输入 n8n-nodes-muapi
  4. 重启 n8n

通过 npm（自托管）

cd ~/.n8n
npm install n8n-nodes-muapi
sudo systemctl restart n8n

Docker

将以下环境变量加入 Docker 配置：

N8N_COMMUNITY_PACKAGES=n8n-nodes-muapi

凭据设置

  1. 在 muapi.ai 注册，然后前往 Dashboard → API Keys → Create Key
  2. 在 n8n 中前往 Credentials → New Credential → MuAPI API
  3. 粘贴 API key 并保存

系统会根据你的账户余额自动验证凭据。

节点

1. MuAPI（预测器）

主要的生成节点。选择一个类别，然后选择一个模型 — 节点会动态加载该类别下所有可用模型。

类别和模型：

类别代表模型
Text to ImageFLUX Kontext Pro、FLUX Dev、FLUX Schnell、FLUX Kontext Dev/Max、HiDream Fast/Dev/Full、GPT-4o、Midjourney V7、Reve、Wan 2.1、Seedream 3/4、Qwen
Image to ImageFLUX Kontext Dev/Pro/Max（I2I）、FLUX Kontext Effects、GPT-4o Edit、Reve Edit、Midjourney V7（I2I/Style/Omni）、SeedEdit、Qwen Edit
Text to VideoVeo 3、Veo 3 Fast、Wan 2.1/2.2、Runway、Kling V3 Pro/Standard、Seedance Pro/V1.5、MiniMax Hailuo 02 Pro、HunyuanVideo、PixVerse、Sora 2 Pro
Image to VideoVeo 3、Veo 3 Fast、Wan 2.1/2.2、Runway、Kling V3、Seedance、Midjourney V7、HunyuanVideo、PixVerse、Sora 2
Image EnhanceAI Upscale、Background Remover、Face Swap、Skin Enhancer、Photo Colorizer、Ghibli Style、Anime Generator、Image Extender、Object Eraser、Product Shot
Video EditWan AI Effects、Face Swap（视频）、Dress Change、AI Clipping、Lipsync
AudioSuno Create/Remix/Extend、MMAudio Text-to-Audio、MMAudio Video-to-Audio

执行流程：

  1. 向 POST /api/v1/{endpoint} 提交请求
  2. 自动轮询 GET /api/v1/predictions/{id}/result，直到任务完成
  3. 返回完整结果，其中包括生成媒体 URL 的 outputs 数组

选项：

选项默认值描述
最大等待时间600s超时前的最大等待时间
轮询间隔3s检查完成状态的频率
仅返回 Request ID关闭立即获取 request_id，不等待任务完成

2. MuAPI Upload

将任意媒体文件上传到 MuAPI，并获取可用于生成任务的托管 CDN URL。

输入模式：

  • 二进制数据 — 接收前一个 n8n 节点（HTTP Request、Read Binary File 等）传入的文件
  • URL — 提供 URL，节点会下载文件并重新上传

支持的格式：

类型格式
图像jpg、jpeg、png、gif、webp、bmp、tiff、svg
视频mp4、mov、avi、webm、mkv
音频mp3、wav、ogg、flac、m4a、aac

输出：

{
  "url": "https://cdn.muapi.ai/uploads/your-file.jpg",
  "filename": "your-file.jpg",
  "mimeType": "image/jpeg",
  "size": 204800
}

示例 Workflow

文本转图像

[Manual Trigger]
  → [MuAPI: Text to Image — FLUX Dev]
  → [HTTP Request: Download image]

图像转视频管线

[Read Binary File: photo.jpg]
  → [MuAPI Upload]                        ← 获取托管 URL
  → [MuAPI: Image to Video — Kling V3]    ← 将 URL 用作 image_url
  → [HTTP Request: Download video]

自动化产品摄影

[Schedule Trigger]
  → [HTTP Request: fetch product image]
  → [MuAPI Upload]
  → [MuAPI: Image Enhance — Product Shot]
  → [MuAPI: Image Enhance — AI Upscale]
  → [Send Email: attach result]

Suno 音乐生成

[Webhook Trigger]
  → [MuAPI: Audio — Suno Create Music]
  → [Slack: post audio URL]

异步生成（手动发送和轮询）

[Manual Trigger]
  → [MuAPI: Text to Video — Veo 3]        ← 开启“Return Request ID Only”
  → [Wait 60s]
  → [HTTP Request: GET /api/v1/predictions/{request_id}/result]

在其他节点中使用托管 URL

MuAPI Upload 输出的 url 或 MuAPI 输出的 outputs[0] 可以直接传给任何 n8n 节点：

{{ $json.url }}                   ← 上传结果
{{ $json.outputs[0] }}            ← 生成结果

API 模式参考

所有 MuAPI 生成调用都遵循异步的“提交 → 轮询”模式：

POST /api/v1/{endpoint}
  → { "request_id": "abc123" }

GET /api/v1/predictions/abc123/result
  → { "status": "completed", "outputs": ["https://cdn.muapi.ai/..."] }

MuAPI 节点会自动处理这一流程。状态值为 pending、processing、completed 和 failed。

快速开始

  1. 通过 Settings → Community Nodes 安装 n8n-nodes-muapi
  2. 添加凭据：MuAPI API → 粘贴 API key
  3. 将 MuAPI 节点拖入画布
  4. 选择一个类别（例如“Text to Image”）和一个模型（例如“FLUX Dev”）
  5. 输入提示词并点击 Execute node

生成的图像、视频或音频 URL 会显示在输出面板中。

源代码

节点包是开源的：

欢迎提交 Pull Request 和 Issue。

n8n 集成 — Muapi Docs