{"id":15013792,"url":"https://github.com/softmeng/comfy-flow-api","last_synced_at":"2026-03-15T20:40:09.110Z","repository":{"id":213032166,"uuid":"732854513","full_name":"SoftMeng/comfy-flow-api","owner":"SoftMeng","description":"对ComfyUI的API进行的一层封装，并提供了微信小程序授权的API","archived":false,"fork":false,"pushed_at":"2025-03-13T09:08:09.000Z","size":15481,"stargazers_count":182,"open_issues_count":2,"forks_count":21,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T15:08:00.685Z","etag":null,"topics":["comfy","comfyui","comfyui-manager","quarkus","stable-diffusion-webui"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SoftMeng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-18T02:23:58.000Z","updated_at":"2025-03-20T06:43:31.000Z","dependencies_parsed_at":"2023-12-18T03:29:46.389Z","dependency_job_id":"3b4e6e0e-1122-42fd-8116-aff37cc8ed83","html_url":"https://github.com/SoftMeng/comfy-flow-api","commit_stats":{"total_commits":21,"total_committers":3,"mean_commits":7.0,"dds":"0.47619047619047616","last_synced_commit":"1611c0ddca03da5d10b66ae5c5cb725e4f771be8"},"previous_names":["softmeng/comfy-flow-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftMeng%2Fcomfy-flow-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftMeng%2Fcomfy-flow-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftMeng%2Fcomfy-flow-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SoftMeng%2Fcomfy-flow-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SoftMeng","download_url":"https://codeload.github.com/SoftMeng/comfy-flow-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246049631,"owners_count":20715511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["comfy","comfyui","comfyui-manager","quarkus","stable-diffusion-webui"],"created_at":"2024-09-24T19:44:47.281Z","updated_at":"2026-03-15T20:40:09.038Z","avatar_url":"https://github.com/SoftMeng.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./doc/icon.jpg\" width=\"256px\"/\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n    富强、民主、文明、和谐、合规\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n    自由、平等、公正、法治、合法\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n    爱国、敬业、诚信、友善、合理\n\u003c/div\u003e\n\n# comfy-flow-api\n\n这是一个ComfyUI的API聚合项目，针对ComfyUI的API进行了封装，比较适用的场景如下\n\n1. 给微信小程序提供AI绘图的API;\n2. 封装大模型的统一API调用平台,实现模型多台服务器的负载均衡;\n3. 启用JOB，可以在本地自动生成AI图片，生成本地的图片展览馆;\n4. 定制不同的工作流，通过API进行调用;\n\n依赖：\nJDK 17 +\nMaven 3.8.6 +\n\n## 配置文件解释\n\n### application.properties 配置文件\n\n我们需要修改如下配置\n\n#### 微信小程序配置（如果需要小程序微信登陆时，需要配置）\n\n```\nwechat.appid=小程序 appId\nwechat.secret=小程序 appSecret\n```\n#### ComfyUI服务的Ip(如果想使用ComfyUI进行图像生成时，需要配置)\n```\ncomfy.ips=ComfyUI所在服务器的IP，比如`127.0.0.1`\n```\n#### 生成的图片的存储地址(默认是放到磁盘里，我的磁盘地址是`/Users/xiangyuanmeng/Documents/MyProjectSpace/comfy-flow-api/static/`，需要替换)\n```\nfile.storage.type=disk\nfile.storage.disk=/Users/xiangyuanmeng/Documents/MyProjectSpace/comfy-flow-api/static/\nfile.storage.view=http://127.0.0.1:8189/static/\n```\n其中\n\n1. 类型目前只支持本地磁盘，即`file.storage.type=disk`;\n2. 生成的图片存储在磁盘上，通过`file.storage.disk=/xxx/xxx/`配置磁盘文件夹;\n3. 生成的图片可以进行访问，通过`file.storage.view=`进行配置；\n\nPS：若需要使用阿里云的对象存储、Aws的S3存储、SM.MS等其他存储方式，需要扩展[FileStorage.java](src%2Fmain%2Fjava%2Fcom%2Fmexx%2Fcomfy%2Fservice%2FFileStorage.java)进行实现。\n\n### comfyui.json 配置文件\n\n我们需要修改如下配置\n\n```json\n[\n  {\n    \"name\": \"工作流的名称，比如动漫风格转换\",\n    \"path\": \"在服务器上，动漫风格转换的workflow-api.json所在的位置，比如/comfyui/workflow-api.json\"\n  }\n]\n```\n\n## 工作流修改\n\n工作流文件中，某些需要替换的参数需要替换，可以参考：[角色设计XL-简单的二次元.json](src/main/resources/comfy/%E8%A7%92%E8%89%B2%E8%AE%BE%E8%AE%A1XL-%E7%AE%80%E5%8D%95%E7%9A%84%E4%BA%8C%E6%AC%A1%E5%85%83.json)\n\n目前支持：\n\n1. ___seed___  随机种子\n2. ___prompt___ 提示词\n3. ___negative_prompt___ 反向提示词\n4. ___image___ 图片\n5. ___localDate___ 日期\n6. ___localTime___ 时间\n7. ___key___ 关键字\n\n## 本地测试\n\n### 使用到的组件清单\n\n可以访问地址: http://127.0.0.1:8189/q/dev-ui/extensions\n\n![img.png](doc%2Fimg_0.png)\n\n### 接口API清单\n\n可以访问地址: http://127.0.0.1:8189/q/swagger-ui/\n\n![img_1.png](doc%2Fimg_1.png)\n\n### 简单使用\n\n可以访问地址: http://127.0.0.1:8189/drawNow.html\n\n![img_3.png](doc%2Fimg_3.png)\n\n这个工作流使用到的资源如下\n\n1. 模型: https://www.liblib.art/userpage/0f37258e861044879b8728309c0ac3b0/publish\n2. 插件: https://github.com/SoftMeng/\n\n只是个流程测试，没有进度条。\n\n## 部署（Jar包形式）\n\n对项目进行打包\n\n```shell script\n./mvnw package -Dquarkus.package.type=uber-jar\n```\n\n打完包的程序在`target`中，安装JDK17或者21后，可以使用命令行启动\n\n```shell\njava -jar target/comfy-flow-api-runner.jar\n```\n\n## 部署（Native形式）\n\n这需要你安装GraalVM\n\n```shell script\n./mvnw package -Dnative -Dquarkus.native.container-build=true\n```\n\n打包后可以使用下面命令启动\n\n```shell\n./target/comfy-flow-api-1.0.0-SNAPSHOT-runner\n```\n\n## 使用步骤\n\n### 1. 导出ComfyUI的API格式工作流\n\n[ComfyUI导出API格式工作流.mp4](doc%2Fvedio%2FComfyUI%E5%AF%BC%E5%87%BAAPI%E6%A0%BC%E5%BC%8F%E5%B7%A5%E4%BD%9C%E6%B5%81.mp4)\n\n### 2. 放入到工程文件夹中\n\n![step2.png](doc%2Fstep2.png)\n\n### 3. 将工作流文件和名称的对应关系写入到comfyui.json文件中\n\n![step3.png](doc%2Fstep3.png)\n\n### 4. 在drawNow.html中修改为“我的工作流AAA”\n\n![step4.png](doc%2Fstep4.png)\n\n### 5. 修改工作流API的参数\n\n![step5.png](doc%2Fstep5.png)\n![step6.png](doc%2Fstep6.png)\n\n### 6. 启动工程\n\n访问: http://localhost:8189/drawNow.html\n\n![drawNow.png](doc%2FdrawNow.png)\n\n### 7. 开启JOB\n\n配置文件开启JOB, 在配置文件里开启\n\n![job.png](doc%2Fjob.png)\n\n启动JOB后可以看到日志，正在执行生图的任务\n\n![jobresult.png](doc%2Fjobresult.png)\n\n### 8. 访问本地生成的图片\n\n访问: http://localhost:8189/lib.html 点击搜索\n\n![lib.png](doc%2Flib.png)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftmeng%2Fcomfy-flow-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftmeng%2Fcomfy-flow-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftmeng%2Fcomfy-flow-api/lists"}