开始 - runninghub-api

1. 介绍

🎉

欢迎使用 RunningHub API
通过 API，您可以将 RunningHub 云端的 ComfyUI 工作流无缝集成到您的产品中，实现批量处理与自动化运行。

核心优势：

云端执行

直接调用 RunningHub 算力运行各类复杂工作流。

批量处理

支持连续发起任务与批量运行。

无缝迁移

凡是在 RunningHub 平台上能正常运行的工作流，均可直接通过 API 调用。

2. 开始使用

2.1 准备工作

在发起 API 调用前，请完成以下准备事项：

注册账号

访问 https://www.runninghub.cn/ 注册 RunningHub 账号

开通会员

开通基础版及以上会员（免费用户暂不支持 API 调用）

获取 Workflow ID

打开目标工作流页面，从浏览器地址栏获取 ID。

以https://www.runninghub.cn/#/workflow/1850925505116598274 为例：
其中ID 为 1850925505116598274

注意：目标工作流必须在网页端手动成功运行过至少一次，否则 API 调用将报错。

2.2 获取 API KEY

RunningHub 为每位用户分配唯一的 32 位 API KEY 用于身份验证。
获取方式

点击右上角头像悬浮窗，进入「API 控制台」。

复制并妥善保管您的 API KEY（请勿泄露给第三方）。
API Key入口

3. 账户类型说明

API 调用方式一致，但根据账户类型不同，计费与权益有所区别：

类型	适用场景	计费模式	并发支持
消费级	基础会员及以上	消耗 RH 币费率与网页端运行工作流一致	默认单任务
企业级-共享	需充值余额	按实际运行时间计费详见网站资费说明	支持高并发默认支持 100 并发
企业级-独占	购买独占机器	根据不同机器类型付费详见网站资费说明	并发数同购买机器数量

FAQ 常见问题

API 如何计费？

消费级 API 没有独立计费体系，价格与在网页端运行同一个工作流完全一致，仅通过 API 触发执行。

如何实现高并发（同时发起多个任务）？

如果工作流包含多个 Save 节点，结果如何返回？

图生图 (Img2Img) 场景下如何上传图片？

返回 `APIKEY_INVALID_NODE_INFO` 错误？

返回 `APIKEY TASK STATUS ERROR` 错误？

开始

1. 介绍#

2. 开始使用#

2.1 准备工作#

2.2 获取 API KEY#

3. 账户类型说明#

FAQ 常见问题#

1. 介绍

2. 开始使用

2.1 准备工作

2.2 获取 API KEY

3. 账户类型说明

FAQ 常见问题