RunningHub MiniMax H3 参考视频

用途

RunningHub MiniMax H3 是由部署方统一接入的内部视频模型。模型选择器中的名称为 RunningHub / MiniMax H3 Reference to Video。它支持纯文本生成，也可在 Canvas 视频节点中结合参考图片、视频和音频。用户无需也无法接触 RunningHub API Key 或工作流 JSON。

使用前准备

部署管理员需要为应用服务和任务 Worker 配置同一组环境变量，然后重启两者：


RUNNINGHUB_ENABLED=true
RUNNINGHUB_API_KEY=服务端密钥
# 可选；不设置时使用 RunningHub 官方地址
RUNNINGHUB_BASE_URL=https://www.runninghub.ai

该 Provider 默认关闭。管理员还需在 管理后台 → 模型配置 中把该模型的执行模式设为「代码动态工作流」、启用模型并发布价格修订；同时满足目录状态、RUNNINGHUB_ENABLED=true 和 RUNNINGHUB_API_KEY 非空时，模型才会出现在视频模型列表中。动态模式不要求绑定固定工作流。用户不能自行填写或更换密钥。

两种接入方式：

管理后台（推荐）：在「管理后台 → 供应商」配置独立的 type=runninghub 实例，密钥保存在数据库行。该行尚未保存 API Key 时，启用（拨开关 / 保存）会自动检测 .env 的 RUNNINGHUB_API_KEY 并加密写入（双源 key 迁移桥），也可直接在编辑表单填写；数据库优先于环境变量。

旧环境变量方式（兼容）：仅通过上方 dotenv 配置启用，适用于仍依赖 RUNNINGHUB_ENABLED=true + RUNNINGHUB_API_KEY 的存量部署，已标记弃用但保留向后兼容。

参考素材可全部省略：图片支持 0–9 张，参考视频支持 0–2 段，独立参考音频支持 0–2 段。参考视频只传画面；需要声音条件时，请单独连接参考音频。纯文本模式表示不连接任何媒体，此时提示词必须非空；独立参考音频不能作为唯一媒体输入。

可选时长为 5–15 秒之间的每个整数，画幅支持 16:9 和 9:16，分辨率支持 480p、720p、1K 和 2K。默认保持原工作流的 1K。兼容调用传入 1–4 秒时，服务端会按 5 秒执行；0、负数、小数、NaN 或大于 15 秒的值会在上传素材前被拒绝。

配图占位

页面：自由 Canvas 的视频节点或现有视频生成参考资产区域

状态：部署方已启用 RunningHub，模型选择器显示 RunningHub / MiniMax H3 Reference to Video

重点区域：纯文本提示词、参考素材连线、5–15 秒选项和生成按钮

脱敏要求：隐藏项目素材内容、账号信息、API Key、Token 和余额

操作步骤

在自由 Canvas 视频节点或现有视频生成流程中选择 RunningHub / MiniMax H3 Reference to Video。
在 5–15 秒的整数选项中选择时长，再选择 16:9 或 9:16 画幅与 480p、720p、1K 或 2K 分辨率。
纯文本生成时不连接任何媒体，并输入非空提示词。使用参考素材时，可添加 0–9 张图片、0–2 段视频和 0–2 段独立音频，不需要为未使用的名额添加占位素材。
核对提示词、时长和参考连线后提交生成。

结果与状态

服务端先校验输入，再上传本次实际使用的参考资产，并动态构建仅包含这些资产节点的 MiniMax H3 工作流。内部托管素材会直接通过存储服务读取，不再绕行应用自身的 HTTP 下载接口；外部参考地址发生瞬时连接异常时会重试一次。上传时会根据素材 MIME 为无扩展名地址补全受支持的文件扩展名；RunningHub 上传遇到网络异常、限流或服务端临时错误也会原地重试一次，且不会重复读取源素材。RunningHub 云端提交时携带的平台工作流 ID（workflowId）不再在代码中硬编码：它是初始化数据，由 scripts/seed-comfyui-workflows.ts 预置到 comfy_ui_workflows 表中 minimax-h3-reference-to-video 行（值为 2086743729407733762），运行时从数据库行读取并随完整动态工作流 JSON 一并提交；管理员可在 管理后台 → ComfyUI 工作流 选中该行后用同一 workflowId「刷新 JSON」，同步 RunningHub 平台的最新模板体。提交后任务进入异步处理，页面沿用其他视频模型的任务状态显示并自动轮询；查询接口返回顶层任务对象或 data 包装对象时都能识别最终状态，明确的运行中或成功状态不会被响应中的历史错误文本覆盖。

分辨率节点按所选画幅和像素档位动态计算宽高，并保持 32 像素倍数，因此最终像素尺寸由 RunningHub 工作流节点确定。

任务完成后，系统只接受 MP4 视频结果，并将其转存为当前流程的标准视频资产。工作流完成但没有 MP4 输出时，任务会明确失败。

权限和边界

RunningHub 是内部、环境变量控制的 Provider；API Key 只保存在服务端，不提供用户配置入口。应用和 Worker 必须使用同一组环境变量。
图片、参考视频和独立参考音频的上限分别为 0–9、0–2 和 0–2；参考视频只传画面，需要声音时请单独连接参考音频。
纯文本生成不连接任何媒体，提示词必须非空；独立参考音频不能单独作为媒体输入。
用户可选时长是 5–15 秒的每个整数；1–4 秒兼容输入归一为 5 秒，非法时长在素材上传前失败。
画幅仅支持 16:9 和 9:16；分辨率仅支持 480p、720p、1K 和 2K，默认为 1K。
用户不能切换 RunningHub 工作流、编辑工作流 JSON 或覆盖部署方配置。
管理后台未启用、未发布价格修订、环境开关关闭或 API Key 缺失时，模型不会出现在用户可选模型中。

常见问题

为什么看不到模型？

请让部署管理员确认 RUNNINGHUB_ENABLED=true、RUNNINGHUB_API_KEY 非空，并在修改环境变量后重启应用和 Worker。Docker Compose 部署还应确认变量已提供给 Compose 进程。

为什么任务在完成时仍显示失败？

系统只接收并转存 MP4 输出。若 RunningHub 任务完成但没有返回 MP4，请由部署管理员检查该工作流的输出节点和 RunningHub 任务记录。

不上传图片或视频可以生成吗？

可以。纯文本生成时不上传任何媒体，但必须提供非空提示词。若使用参考素材，系统只会为实际输入动态构建工作流，不会补占位素材。

为什么 1–4 秒的请求输出 5 秒？

这是服务端兼容规则。1–4 秒会按 5 秒执行；Canvas 对用户展示的正常选项是 5–15 秒之间的每个整数。0、负数、小数、NaN 或大于 15 秒的值不会开始上传。

如何接入一条新的 RunningHub 工作流？

「ComfyUI 工作流（comfyui workflow）」是两种独立 Provider 可复用的 JSON 载体；RunningHub 仍使用自己的提交、轮询和错误码。接入方式在 管理后台 → ComfyUI 工作流 页面选择：

本地 ComfyUI 服务：直接粘贴/拖入 .json 文件（/prompt 端点格式），保存即可。
RunningHub 云端：粘贴 RunningHub 平台侧工作流模板 ID（如 2096515700701929473），点击「拉取 JSON」自动同步该 ID 在平台上的最新 /prompt JSON 上屏确认，保存时 workflowId 与 JSON 一起落盘。之后选中该行可随时用同一 workflowId「刷新 JSON」重新拉取平台最新模板体。

数据库行保存的是平台侧权威模板，因此 RunningHub 模式下保存会放行平台自定义节点（本地白名单之外的 class_type 降级为警告而非报错）；本地模式仍执行 4 项硬校验。固定模式需要写入 global_models.comfyUiWorkflowId；代码动态模式无需固定绑定，但仍通过对应工作流行的 runninghubWorkflowId 定位远端执行环境。