简介

欢迎使用 RunningHub API，轻松调用 RunningHub 云端的 ComfyUI 功能。

通过 API，能够批量运行各类复杂工作流并连续发起运行任务。只要工作流能在 RunningHub 平台上正常运行，您就能将其无缝集成到您的产品中，或在任何需要 AI 工作流的场景中灵活应用。

开始使用

在使用 RunningHub API之前，请做好如下准备：

第一，先注册成为RunningHub网站的用户，并完成会员权益的开通。免费用户暂不能使用RunningHub API。

第二，打开一个工作流，记录该流在地址栏中的workflow ID, 因为我们的API调用都是基于workflow ID的。

比如下图这个地址(https://www.runninghub.cn/#/workflow/1850925505116598274)的workflow ID就是1850925505116598274。注意这个流一定要手动运行成功过，否则API调用时会报错。

1. 获取API KEY

RunningHub 为每位用户自动生成一个独特的 32 位 API KEY，作为身份的唯一标识。

打开https://runninghub.cn的首页，登录账号后，打开页面右上角的头像悬浮窗，就能看到您的API KEY。请妥善保存您的 API KEY，不要外泄，后续步骤将依赖此密钥进行操作。

2. 简易运行 workflow

该方式运行 workflow，相当于在不改变原有workflow的任何参数的情况下，直接点了一下"运行"按钮。

适合随机种子抽卡。

接口：POST /task/openapi/create

• headers：

  header	value	备注
  Content-Type	application/json

• 请求data-raw：

  参数	类型	是否必需	备注
  workflowId	string	是
  apiKey	string	是

• 返回值：

  参数	类型	备注
  msg	string	正常为：success
  data: taskId	string	本次运行的taskid，与网站上工作台里的任何列表里的里taskid是一一对应的
  data:clientId	string	本次运行的clientId，排错用，一般忽略即可
  data:promptTips	string	如果出错，具体的错误信息
  data:taskStatus	string	QUEUED(排队中),RUNNING(运行中),SUCCEDD（运行完成，运行成功）,FAILED（运行完成，运行失败）