已经为你更新了文档。我将 retainSeconds 参数添加到了附加参数（可选）表格中，并新增了一个专门的使用说明小节，同时在示例请求体中展示了其用法。

发起 ComfyUI 任务（高级）

该接口用于基于已有的工作流模板（workflow）自定义节点参数，发起 ComfyUI 图像生成任务。

适用于修改任意节点参数的场景，例如修改图生图中的采样器、步数、提示词、种子值等。
通过传入 nodeInfoList 实现动态参数替换，使得任务运行灵活可控。

请求地址

POST https://www.runninghub.cn/task/openapi/create

请求方式

POST，请求体格式为 application/json

请求头部

Header	是否必填	示例值	说明
`Host`	是	`www.runninghub.cn`	API 域名，必须精确填写
`Content-Type`	是	`application/json`	请求体类型

请求参数

基础参数（必填）

参数名	类型	是否必填	说明
`apiKey`	string	是	用户的 API 密钥，用于身份认证
`workflowId`	string	是	工作流模板 ID，可通过平台导出获得
`nodeInfoList`	array	否	节点参数修改列表，用于在执行前替换默认参数
`accessPassword`	string	否	工作流开启加密访问时使用的访问密码

nodeInfoList 结构说明

字段	类型	说明
`nodeId`	string	节点的唯一编号，来源于工作流 JSON 文件
`fieldName`	string	要修改的字段名，例如 `text`、`seed`、`steps`
`fieldValue`	any	替换后的新值，需与原字段类型一致

示例请求体

{
  "apiKey": "your-api-key",
  "workflowId": "1904136902449209346",
  "retainSeconds": 60,
  "nodeInfoList": [
    {
      "nodeId": "6",
      "fieldName": "text",
      "fieldValue": "1 girl in classroom"
    }
  ]
}

附加参数（可选）

参数名	类型	默认值	说明
`addMetadata`	boolean	true	是否在图片中写入元信息（如提示词）
`webhookUrl`	string	无	任务完成后回调的 URL
`workflow`	string	无	自定义完整工作流 JSON，如指定则忽略 `workflowId`
`instanceType`	string	无	指定实例类型（如 `plus`）
`usePersonalQueue`	boolean	false	独占类型任务是否进入个人排队队列
`retainSeconds`	Integer	无	实例保留时长（10~180秒），详见下方说明

retainSeconds 使用说明

仅对企业共享 API Key 生效。设置此参数后，任务成功结束后会在指定时长内优先复用同用户同工作流实例，从而减少冷启动时间与排队等待。

费用：该保留时段会产生额外费用，按实际保留时长计费。

取值范围：10 ~ 180 秒。

"retainSeconds": 60

usePersonalQueue 使用说明

此参数只对独占类型的apiKey生效，若不想自己控制排队，可设置此参数为true，任务会自动进入排队状态，当用户持有的独占机器空闲时会自动执行；
注意：单用户排队的数量限制为1000，超过会返回错误码(814, "PERSONAL_QUEUE_COUNT_LIMIT")

instanceType 使用说明

若希望发起plus任务到48G显存机器上执行，可设置 instanceType 参数。例如：

"instanceType": "plus"

webhookUrl 使用说明（高级）

若希望任务执行完成后平台自动通知结果，可设置 webhookUrl 参数。任务完成后，RunningHub 会向该地址发送如下 POST 请求：

{
  "event": "TASK_END",
  "taskId": "1904163390028185602",
  "eventData": "{\"code\":0,\"msg\":\"success\",\"data\":[{\"fileUrl\":\"...\",\"fileType\":\"png\",\"nodeId\":\"9\"}]}"
}

返回结果

成功响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "1910246754753896450",
    "taskStatus": "QUEUED",
    "clientId": "e825290b08ca2015b8f62f0bbdb5f5f6"
  }
}

返回字段说明

字段名	类型	说明
`code`	int	状态码，0 表示成功
`msg`	string	提示信息
`data`	object	返回数据对象

data 子字段说明

字段名	类型	说明
`taskId`	string	创建的任务 ID
`taskStatus`	string	初始状态：`QUEUED`、`RUNNING`、`FAILED`
`promptTips`	string	ComfyUI 校验信息，可用于识别配置异常节点

使用建议

✅ 在调用前请确认 nodeId 和 fieldName 的准确性。

✅ 推荐通过 webhookUrl 接收结果通知，或轮询状态与结果接口。

✅ 针对高频调用场景，建议设置 retainSeconds 以获取更快的响应速度。

发起ComfyUI任务2-高级

发起 ComfyUI 任务（高级）

请求地址

请求方式

请求头部

请求参数

基础参数（必填）

nodeInfoList 结构说明

示例请求体

附加参数（可选）

retainSeconds 使用说明

usePersonalQueue 使用说明

instanceType 使用说明

webhookUrl 使用说明（高级）

返回结果

成功响应示例

返回字段说明

data 子字段说明

使用建议

相关接口

请求参数

请求示例代码

返回响应

发起ComfyUI任务2-高级

发起 ComfyUI 任务（高级）#

请求地址#

请求方式#

请求头部#

请求参数#

基础参数（必填）#

nodeInfoList 结构说明#

示例请求体#

附加参数（可选）#

retainSeconds 使用说明#

usePersonalQueue 使用说明#

instanceType 使用说明#

webhookUrl 使用说明（高级）#

返回结果#

成功响应示例#

返回字段说明#

data 子字段说明#

使用建议#

相关接口#

请求参数

请求示例代码

返回响应

发起 ComfyUI 任务（高级）

请求地址

请求方式

请求头部

请求参数

基础参数（必填）

nodeInfoList 结构说明

示例请求体

附加参数（可选）

retainSeconds 使用说明

usePersonalQueue 使用说明

instanceType 使用说明

webhookUrl 使用说明（高级）

返回结果

成功响应示例

返回字段说明

data 子字段说明

使用建议

相关接口