通过 VideoUpscaler API、Webhook 回调、一键导入模板与社区节点，在 n8n、Zapier、Make、Dify 和扣子（Coze）中自动化 AI 视频超分。

将 1080p、2K 或 4K 视频超分接入你的自动化流水线——例如当新视频上传到 Google Drive、S3 或飞书/Slack 时，或在 Kling、Runway、Veo 等 AI 视频生成完成后自动放大画质并发布。

仅限付费账号

工作流集成调用 VideoUpscaler API 并消耗账号积分。请使用购买过积分或已订阅的账号，在设置 → API 密钥中创建密钥（形如 vu_live_…）。

快速下载与模板

资源	链接	适用场景
n8n 社区节点	`n8n-nodes-videoupscaler`	在自建或云端 n8n 中单节点完成提交与等待结果
n8n 工作流模板	n8n-videoupscaler-workflow.json	直接导入 n8n（HTTP Request + 45 秒长轮询闭环）
Make 蓝图模板	make-videoupscaler-blueprint.json	直接导入 Make.com 场景
OpenAPI 3.1 规范	openapi.json	在 Dify、Coze（扣子）、Postman 和 OpenAI Actions 中一键导入工具

n8n 集成

支持三种方式接入 n8n：安装官方社区节点、导入现成的 .json 工作流模板，或在 n8n AI Agent 中直接挂载远程 MCP 服务器。

在 n8n 中打开 Settings → Community Nodes，点击 Install 并输入：

n8n-nodes-videoupscaler

在画布中添加 VideoUpscaler 节点。
新建 VideoUpscaler API 凭证并填入你的 vu_live_… 密钥。
选择 Resource: Video、Operation: Upscale，填入 Video URL 和 Resolution（1080p、2k 或 4k）。
保持 Wait for Completion 开启——节点会自动等待 GPU 任务完成并直接输出 output_url。

无需安装任何插件，适用于所有 n8n 环境：

下载 n8n-videoupscaler-workflow.json。
在 n8n 画布右上角菜单（⋯）选择 Import from File… 导入该文件。
打开 Start Upscale 和 Poll Task 两个 HTTP Request 节点，选择 Header Auth 并配置：
- Name: Authorization
- Value: Bearer vu_live_YOUR_API_KEY

模板默认使用 Idempotency-Key: {{ $execution.id }} 防止重复扣费，并通过 GET /api/v1/tasks/{{ $json.id }}?wait=45 长轮询直到状态变为 completed。

如果你的 n8n 工作流使用了 AI Agent 节点，可直接挂载 MCP Client Tool 节点：

Endpoint: https://videoupscaler.co/api/mcp
Authentication: Header Auth（Authorization: Bearer vu_live_YOUR_API_KEY）

Agent 会自动发现并调用 upscale_video、get_task、list_tasks 和 get_account。

Zapier 集成

由于视频超分耗时通常在几十秒到数分钟之间，在 Zapier 中推荐使用 webhook_url 回调模式（两个 Zap 配合）：

Zap 1 — 触发并提交超分任务

Trigger（触发器）： 选择视频来源（如 Google Drive — New File in Folder 或 Dropbox — New File）。
Action（动作）： 选择 Webhooks by Zapier → Custom Request（或 POST）：
- Method: POST
- URL: https://videoupscaler.co/api/v1/upscale
- Headers:
  - Authorization: Bearer vu_live_YOUR_API_KEY
  - Content-Type: application/json
- Data (JSON):

{
  "video_url": "https://your-public-file-link.mp4",
  "resolution": "4k",
  "webhook_url": "https://hooks.zapier.com/hooks/catch/YOUR_ZAP_2_HOOK"
}

Zap 2 — Webhook 接收超分结果

Trigger（触发器）： 选择 Webhooks by Zapier → Catch Hook，将生成的 Webhook 地址填入 Zap 1 的 webhook_url。
Filter（可选）： 当 status 等于 completed 时继续执行。
Action（动作）： 将返回的 output_url 传给 Google Drive — Upload File、Slack 或自动发布步骤。

Make (Integromat) 集成

下载 make-videoupscaler-blueprint.json。
在 Make 新建 Scenario，点击底部工具栏 More (⋯) → Import Blueprint 上传该文件。
将两个 HTTP — Make a request 模块 Header 中的 vu_live_YOUR_API_KEY 替换为你的 API 密钥。

对于短视频，第二个模块（GET https://videoupscaler.co/api/v1/tasks/{{1.data.id}}?wait=45）会保持连接最多 45 秒并在单次运行内直接返回 output_url；对于长视频，可将 Make 的 Custom webhook 地址传入 POST /api/v1/upscale 的 webhook_url 字段。

Dify、扣子（Coze）与 OpenAI Actions

支持 OpenAPI 规范的平台可以一键导入全部接口：

Schema 地址： https://videoupscaler.co/openapi.json
认证方式： API Key / Bearer（Authorization: Bearer vu_live_…）

在 Dify（工具 → 自定义 → 创建自定义工具）或 Coze（插件 → 创建插件 → 从 OpenAPI 导入）中粘贴 /openapi.json 的内容，并配置 Bearer Token 即可。

Webhook 回调与长轮询参数说明

Webhook 回调（`webhook_url`）

在 POST /api/v1/upscale 请求体中传入 webhook_url（公网 https:// 地址）：

curl https://videoupscaler.co/api/v1/upscale \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/clip.mp4",
    "resolution": "4k",
    "webhook_url": "https://hooks.example.com/videoupscaler"
  }'

当任务完成或失败时，VideoUpscaler 会向 webhook_url 发送 POST 请求：

请求头 X-VideoUpscaler-Event: task.completed 或 task.failed
请求头 X-VideoUpscaler-Task-Id: 任务 ID
JSON 请求体：完整的任务对象（成功时含 output_url，失败时含 error 且积分自动退回）

长轮询等待（`?wait=45`）

在 GET /api/v1/tasks/{id} 后附加 ?wait=45（1–45 秒），服务端会等待任务完成或超时后再返回，减少工作流轮询次数：

curl "https://videoupscaler.co/api/v1/tasks/TASK_ID?wait=45" \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY"

视频增强参数（`ops`）

提交超分时还可以附加可选的 ops 对象，同时开启去噪、防抖、补帧、人脸修复或动漫模型：

{
  "video_url": "https://example.com/clip.mp4",
  "resolution": "4k",
  "ops": {
    "engine": "flashvsr",
    "denoise": 2,
    "stabilize": true,
    "faceRestore": false,
    "fpsMultiplier": 2
  }
}

工作流集成（n8n、Zapier 与 Make）