ComfyUI API¶

ComfyUI API功能是AutoDL将ComfyUI工作流进行包装后暴露工作流核心参数进行推理的API服务。ComfyUI API页面的不同工作流的接入流程和整体API参数基本一致，主要区别在于：工作流ID不同、提交任务时与工作流相关的入参会有差异。以下以MiniMax H3文生图工作流为例说明：

API调用过程分两步：

第一步：提交任务，这一步只会立即返回任务ID，需在第二步查询推理生成的结果，如图片、视频等

第二步：异步查询任务

第一步：提交任务¶

请求URL

POST https://autodl.art/api/v1/comfyui/comfyui_workflow/{workflow_id}

其中：{workflow_id} 为工作流ID，可点击工作流后在右侧抽屉页面中可见：

Headers

需要传入鉴权Token：{"Authorization": 您的Token令牌}

Token令牌获取位置：令牌管理点击创建令牌，分组选择：ComfyUI

Request Body

可点击工作流后在右侧抽屉页面中查看，或者使用【在线调用API】在此页面查看

Response Body

提交任务后会返回任务的ID，此ID将用于异步查询任务的生成结果（可能是视频、图片等）

{
    "task_id": "363ba3f5-f4fb-480c-afcf-b9410179c724",
    "workflow": "H3文生视频",
    "status": "QUEUED",
    "client_id": "430e8d3d055baa169c23ba31e49a548d",
    "message": "工作流任务已提交",
    "created_at": "2026-08-14T10:35:28.851743576+08:00"
}

以上返回的Response Body中，task_id为任务ID

¶

第二步：异步查询任务¶

请求URL

POST https://autodl.art/api/v1/comfyui/comfyui_workflow/result/{task_id}

其中：{task_id} 为第一步提交任务返回的task_id

Headers

同提交任务

Request Body

无

Response Body

{
    "task_id": "363ba3f5-f4fb-480c-afcf-b9410179c724",
    "status": "RUNNING",
    "client_id": "430e8d3d055baa169c23ba31e49a548d",
    "created_at": "2026-08-14 10:35:28",
    "started_at": "2026-08-14 10:35:30",
    "duration": 196,
    "results": []
}

以上status为任务状态，可能为QUEUED排队中，RUNNING执行中，SUCCESS成功，当成功后，results字段中将返回生成的图片、视频等资源的URL地址，该URL地址资源有效期较短，获取后请尽快下载保存，超时将无法下载