ComfyUI API

Qwen-Image-2.1 文生图封装:提交工作流 → 轮询状态 → 下载图片。 调用说明见 /SKILL.md;CLI 用 comfyui login 换 token。

登录是两段审批:没登记过的机器先由持有 access code 的人在 /oauth/register 批一次注册,之后浏览器跳到 /oauth/device 由发起登录的人自己确认;批过的机器按指纹记住,下次免注册审批。

方法路径鉴权说明
GET/health免存活检查(含上游 ComfyUI 是否可达)
GET/SKILL.md免完整调用说明(Markdown)
GET/docs免本页
POST/v1/uploadsBearer上传参考图(裸字节,PNG/JPEG/WebP,≤ 10 MB)→ 201 {file_id}
POST/v1/jobsBearer提交作业(单个对象或数组批量,最多 50 项)→ 202
GET/v1/jobs/{id}Bearer状态 / 队列位置 / 图片清单 / 错误 / 耗时
GET/v1/jobs/{id}/images/{index}Bearer下载图片字节
DELETE/v1/jobs/{id}Bearer取消作业(幂等)
POST/v1/jobs/{id}/shareBearer签发限时分享链接(body: {"ttl": 秒},默认 1 小时)
GET/public/jobs/{id}/images/{index}?exp=&sig=免(签名)按分享链接下载图片,过期或篡改即 403
GET/v1/jobs?status=&limit=Bearer最近作业列表
GET/v1/workflowsBearer列出内置模板名
GET/v1/workflows/{name}Bearer取内置模板的 API 格式工作流 JSON
GET/v1/statsBearer负载概览
GET/v1/auth/whoamiBearer当前凭据:kind=shared|token、label、expires_at
GET/v1/tokens共享列出已颁发 token(无明文)
DELETE/v1/tokens/{id}共享吊销单枚 token
DELETE/v1/tokens共享吊销全部已颁发 token
GET/v1/clients共享已登记机器列表(注册审批状态)
POST/v1/clients/{id}/{approve|deny}共享批准 / 拉黑某台机器(免开浏览器)
DELETE/v1/clients/{id}共享忘记某台机器(下次登录重新走注册审批)
POST/oauth/device/code免(同 IP 10s 一次)申请设备码(登录第一步);没登记过的机器要先过注册审批
GET/oauth/register免注册审批页(?user_code= 预填,审批因子 = access code)
POST/oauth/register表单批准 / 拒绝新机器的注册;批准后 303 跳到设备授权页
GET/oauth/device免设备授权页(机器在册时,由发起人自己确认)
POST/oauth/device/approve表单批准 / 拒绝设备码(只要设备码)
POST/oauth/token设备码轮询换 token(registration_pending / authorization_pending / slow_down / access_denied / expired_token)
POST/oauth/revokeBearer自吊销当前 token(comfyui logout)