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/uploads | Bearer | 上传参考图(裸字节,PNG/JPEG/WebP,≤ 10 MB)→ 201 {file_id} |
POST | /v1/jobs | Bearer | 提交作业(单个对象或数组批量,最多 50 项)→ 202 |
GET | /v1/jobs/{id} | Bearer | 状态 / 队列位置 / 图片清单 / 错误 / 耗时 |
GET | /v1/jobs/{id}/images/{index} | Bearer | 下载图片字节 |
DELETE | /v1/jobs/{id} | Bearer | 取消作业(幂等) |
POST | /v1/jobs/{id}/share | Bearer | 签发限时分享链接(body: {"ttl": 秒},默认 1 小时) |
GET | /public/jobs/{id}/images/{index}?exp=&sig= | 免(签名) | 按分享链接下载图片,过期或篡改即 403 |
GET | /v1/jobs?status=&limit= | Bearer | 最近作业列表 |
GET | /v1/workflows | Bearer | 列出内置模板名 |
GET | /v1/workflows/{name} | Bearer | 取内置模板的 API 格式工作流 JSON |
GET | /v1/stats | Bearer | 负载概览 |
GET | /v1/auth/whoami | Bearer | 当前凭据: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/revoke | Bearer | 自吊销当前 token(comfyui logout) |