RunningHub

学习目标

通过本教程，你将掌握：

• 在 RunningHub 上创建并运行 ComfyUI 工作流，实现图像/视频生成
• 调用模型 API 将 AI 能力集成到自有应用或网站
• 使用无限画布功能进行多节点协作与可视化编排
• 管理 AI 应用，实现一键部署与分享

前置条件

• 注册 RunningHub 账号（访问 https://www.runninghub.cn/ ，点击右上角「注册」）
• 确保网络环境稳定，建议使用 Chrome 或 Edge 浏览器
• 准备一个用于测试的 ComfyUI 工作流 JSON 文件（可选，如无则使用平台模板）

分步操作

1. 创建并运行 ComfyUI 工作流

1. 登录后，在左侧导航栏点击「工作流」。
2. 点击「新建工作流」，选择「从空白创建」或「从模板创建」。

• 从模板创建：浏览官方模板库，点击「使用模板」即可加载。
• 从空白创建：点击「导入 JSON」，上传本地的 ComfyUI 工作流 JSON 文件。

3. 工作流加载后，检查节点连接：

• 确保所有节点输入端口（左侧）与输出端口（右侧）正确连接。
• 若节点显示红色警告，表示缺少依赖模型或插件，点击「修复依赖」自动安装。

4. 在右侧「参数面板」中调整核心参数：

• 图像生成：设置宽度、高度（建议 512×512 或 1024×1024）、步数（20-30）、CFG 尺度（7-12）。
• 视频生成：设置帧数、帧率、分辨率。

5. 点击「运行」按钮，等待执行完成。

• 执行时间取决于工作流复杂度与模型大小，通常 30 秒至 5 分钟。
• 结果预览将显示在画布下方，支持下载为 PNG/MP4 文件。

2. 调用模型 API 集成到外部应用

1. 在左侧导航栏点击「API 管理」。
2. 点击「创建 API Key」，输入名称（如「我的应用」），选择权限范围：

• 工作流 API：允许调用已发布的工作流。
• 模型 API：允许直接调用基础模型（如 Stable Diffusion、FLUX）。

3. 复制生成的 API Key（注意：关闭页面后无法再次查看，请妥善保存）。
4. 调用示例（以 curl 为例）：

   curl -X POST https://api.runninghub.cn/v1/workflows/run \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "workflow_id": "your_workflow_id",
       "inputs": {
         "prompt": "a cat sitting on a chair",
         "width": 512,
         "height": 512
       }
     }'

• 替换 YOUR_API_KEY 为实际密钥。
• 替换 your_workflow_id 为工作流详情页中的 ID（格式如 wf_xxxxx）。

5. 返回结果示例：

   {
     "status": "success",
     "output": {
       "images": ["https://cdn.runninghub.cn/output/abc123.png"],
       "seed": 123456789
     }
   }

• 下载链接有效期为 24 小时，建议及时转存。

3. 使用无限画布进行多节点协作

1. 在工作流编辑页面，点击右上角「无限画布」按钮（图标为网格状）。
2. 在画布上拖拽节点，调整布局：

• 使用鼠标滚轮缩放，按住空格键 + 鼠标拖拽平移。
• 选中多个节点（Ctrl+A 全选），右键选择「对齐」或「自动排列」。

3. 添加注释节点：右键点击空白处，选择「添加注释」，输入说明文字（如「此节点用于风格迁移」）。
4. 保存画布布局：点击「保存布局」，下次打开时自动恢复。

4. 部署 AI 应用并分享

1. 完成工作流调试后，点击「发布」按钮。
2. 填写应用信息：

• 名称：如「我的猫图生成器」。
• 描述：简要说明功能（如「输入文字，生成猫咪图片」）。
• 输入参数：选择暴露给用户的参数（如 prompt、尺寸）。

3. 点击「部署」，生成分享链接（格式如 https://app.runninghub.cn/your_app_name）。
4. 将链接分享给用户，用户无需登录即可使用。

预期结果

• 成功运行至少一个 ComfyUI 工作流，并下载输出文件。
• 获得一个可用的 API Key，并测试调用返回有效结果。
• 在无限画布上完成节点布局调整，并保存。
• 部署一个可公开访问的 AI 应用。

常见问题与排查