容器服务
容器服务
文档指南
请输入
- 文档首页
容器服务AI 云原生推理套件ComfyUI 应用ComfyUI 常见问题
复制全文
下载 pdfComfyUI 常见问题
文档反馈
问问助手本文主要描述 ComfyUI 应用相关的常见问题及其解决方法。
如何给 ComfyUI 应用增加账号登录认证能力？
- 登录 智能体身份和权限控制台。
- 创建用户池。按实际情况，自定义配置参数。详情请参见 创建用户池。
- 创建 Web 客户端。部分参数按如下表说明配置，其余参数按实际情况，自定义配置。详情请参见 创建客户端。
-
- 为 ComfyUI 应用设置通用的登录用户信息或者允许用户自行注册。
- 设置通用的登录用户信息：详情请参见 创建用户。
- 允许用户自定注册：详情请参见 配置身份验证信息。
- 登录 容器服务控制台。
- 在 ComfyUI 应用详情 页面 基本信息 页签，单击 服务配置 区域下 API 实例名称，跳转到 API 网关页面。
-
- 配置 OAuth2 单点登录插件。详情请参见 OAuth2 单点登录插件。
注意
- 访问 ComfyUI 应用的服务域名，进入 ComfyUI Web 页面即可弹出登录页面。通过输入通用的登录用户信息或者自行注册用户，登录 ComfyUI Web 页面。
- （可选）按如下方法登出 ComfyUI Web 页面：
- 根据 Web 客户端的 ID token 有效期，超时自动登出。
说明
- 访问https://${ComfyUI服务域名}/signout即可直接登出。
如何改造您自己的 ComfyUI Workflow，使用 ServingKit 的加速节点？
您可以按如下表说明，配置 Workflow 中的模块。
打开 ComfyUI Workflow 提示模型缺失时如何处理？
根据是否有本地模型文件，使用不同的方式处理：
本地有模型文件
- 下载 TOS 的 tosutil 或者 TOSBrowser 工具，后续管理ComfyUI中节点或输入内容下载均可使用该工具。详情请参见 TOS常用工具概览。
- 获取 API 访问密钥，密钥权限至少包含 TOS 读写权限。详情请参见 获取访问密钥。
- 登录 tosutil 或者 TOSBrowser 工具，上传模型文件。下文以 macOS 系统使用 tosutil 通过公网上传模型文件为例。
- 打开本地终端，执行如下命令，注册配置信息。
- ./tosutil config -i $your_ak -k $your_sk -e $your_tos_endpoint -re $your_region## 示例## ./tosutil config -i AK****** -k sk****** -e tos-cn-beijing.volces.com -re cn-beijing
- 执行如下命令，将本地模型文件上传至 TOS 存储桶中 ComfyUI 的models目录下。
注意
TOS 中 ComfyUI 的models目录下根据不同使用场景，会有多个子目录，上传模型文件时需要区分子目录。例如上传 LoRA 模型相关文件，则将目录改成models/loras。ComfyUI 的models目录相关说明，请参见 ComfyUI 官网文档。
- ./tosutil cp $your_local_model_file_path $your_tos_comfyui_models_path -r## 示例## ./tosutil cp /Users/Downloads/qwen-image-edit-2509.safetensors tos://comfyui/models/diffusion_models/ -r
-
本地没有模型文件
- 可通过 Hugging Face、ModelScope 等公共模型库服务下载所需的模型文件并上传至 TOS 桶内。
- 通过 oniond 工具快速下载模型。
- 在 ComfyUI 应用详情 页面 基本信息 页签 服务规格 区域，单击应用对应的实例名称。
- 在实例（Pod）详情页面，单击右上角 控制台，登录 Pod。
- 在 Pod 中执行如下命令下载模型。
- http_proxy="" https_proxy="" oniond download model WanVideo_comfy --include InfiniteTalk/Wan2_1-InfiniTetalk-Single_fp16.safetensors --dir /app/ComfyUI/models/vae/## http_proxy="" https_proxy="" ：表示 http 和 https 配置。若您的 ComfyUI 应用配置了 http_proxy 环境变量时，此处必须配置具体的变量值。## oniond download model WanVideo_comfy --include InfiniteTalk/Wan2_1-InfiniTetalk-Single_fp16.safetensors ：表示下载所需模型。## --dir /app/ComfyUI/models/vae/ ：表示将模型下载到此处指定的目录内。
- 重启 ComfyUI 应用。
-
如何通过 ComfyUI 原生 API 调用 Workflow JSON？
- 在 ComfyUI 应用页面，单击左上角下拉符号，选择 设置，打开 开发模式。
-
- 在 ComfyUI 应用页面，单击左上角下拉符号，选择 文件 > 导出（API），导出需要执行的 Workflow JSON 文件。
- 在您的 Python 环境中创建脚本，通过 ComfyUI 原生 API 调用该脚本：
- 执行模型：创建一个名为prompt.py的 Python 脚本，执行python3 prompt.py 命令，即可执行模型，生成图片。
- prompt.py文件示例代码如下所示，根据代码中的注释说明，自定义调整参数示例值。
- import requestsimport jsonimport osimport randomINPUT_IMAGE_NODE_1 = "17"INPUT_IMAGE_NODE_2 = "25"POSITIVE_PROMPT_NODE = "28"NEGATIVE_PROMPT_NODE = "14"SEED_NODE = "37"WORKFLOW_FILE_PATH = "data/万物迁移-qwenimageedit2509.json" #替换为您自己 Workflow JSON 文件的相对地址。APIGATEWAY_HOST = "sd4034************.apigateway-cn-beijing.volceapi.com" #替换为您自己 ComfyUI 应用的服务域名。headers = {}def generate_image(image_file_name_1, image_file_name_2, prompt, negative_prompt=""):# ComfyUI 应用的访问地址。server_url = f"http://{APIGATEWAY_HOST}"# 加载 Workflow 模板。script_dir = os.path.dirname(os.path.abspath(__file__))workflow_file_path = os.path.join(script_dir, WORKFLOW_FILE_PATH)with open(workflow_file_path, 'r', encoding="utf-8") as f:workflow = json.load(f)# 修改提示词，根据您的 Workflow 节点 ID 自行调整。workflow[POSITIVE_PROMPT_NODE]["inputs"]["prompt"] = prompt # 正面提示词节点。workflow[NEGATIVE_PROMPT_NODE]["inputs"]["prompt"] = negative_prompt # 负面提示词节点。workflow[SEED_NODE]["inputs"]["seed"] = random.randint(0, 999999999999999) # 随机化种子。workflow[INPUT_IMAGE_NODE_1]["inputs"]["image"] = image_file_name_1workflow[INPUT_IMAGE_NODE_2]["inputs"]["image"] = image_file_name_2# 提交提示词。submit_url = f"{server_url}/prompt"response = requests.post(submit_url, json={"prompt": workflow}, headers=headers)if response.status_code == 200:print(f"Response Headers: {response.headers}")prompt_id = response.json()["prompt_id"]print(f"任务已提交! Prompt ID: {prompt_id}")return prompt_idelse:print("提交失败:", response.text)return None# 使用示例。if __name__ == "__main__":prompt_id = generate_image(image_file_name_1="*******.jpg", #图片文件，必须确保文件已经上传。image_file_name_2="*******.png", #图片文件，必须确保文件已经上传。prompt="迁移浅米色坑条纹理、U 领短袖修身版型；保留模特的浅牛仔毛边短裙、腰带、白色包包、红格纹丝巾、白色运动鞋，及浅灰背景与光线，让上衣与模特身形自然贴合、风格统一", #正面提示词内容，请根据实际情况，替换提示词。negative_prompt="色调艳丽，过曝，静态，细节模糊不清，风格，作品，整体发灰，最差质量，低质量，JPEG压缩残留，丑陋的，残缺的，多余的手指，画得不好的手部，画得不好的脸部，畸形的，毁容的，形态畸形的肢体，手指融合，杂乱的背景，三条腿，" #负面提示词内容，请根据实际情况，替换提示词。)print(prompt_id)
- 查询历史记录：创建一个名为history.py的 Python 脚本，执行python3 history.py命令，即可模型的查询历史记录。
- prompt.py文件示例代码如下所示，根据代码中的注释说明，自定义调整参数示例值。
- import requestsimport jsonimport osfrom datetime import datetimefrom PIL import Imageimport ioimport matplotlib.pyplot as plt# 获取当前脚本所在的目录。script_dir = os.path.dirname(os.path.abspath(__file__))# 在模型所在脚本目录下，创建一个用于保存图像的目录。images_dir = os.path.join(script_dir, "comfyui_history_images")os.makedirs(images_dir, exist_ok=True)# headers = {'x-upstream-session-id': 'MTkyLjE2OC4zMi4y******'}headers = {}def get_comfyui_history(server_url="http://127.0.0.1:7860", max_entries=None):"""获取ComfyUI的所有历史记录参数:server_url: ComfyUI服务器地址 (默认: http://127.0.0.1:7860)max_entries: 最多返回的记录数 (默认: 返回全部)返回:包含历史记录的字典，按时间倒序排列"""history_url = f"{server_url}/history"try:response = requests.get(history_url, headers=headers)print(f"----Response Headers----: {response.headers}")response.raise_for_status() # 检查 HTTP 错误。history_data = response.json()# 如果没有历史记录，输出如下内容。if not history_data:print("没有找到历史记录")return {}# 返回条目数上限。如果提供了 max_entries，则限制返回的条目数。if max_entries and max_entries > 0:# 将字典转换为项列表，然后进行切片，再转换回字典。# 注意：字典是无序的，这里的切片是基于 Python 3.7+ 中字典项的插入顺序。# 如果需要特定的顺序，应该在切片前进行排序。items = list(history_data.items())sorted_history = dict(items[:max_entries])else:sorted_history = history_datareturn sorted_historyexcept requests.exceptions.RequestException as e:print(f"获取历史记录失败: {e}")return {}except json.JSONDecodeError:print("解析JSON响应失败")return {}def download_image(image_url, save_path=None):"""下载并显示图像"""try:response = requests.get(image_url, headers=headers)response.raise_for_status()print(f"----Response Headers----: {response.headers}")# 从字节数据创建图像。img = Image.open(io.BytesIO(response.content))# （可选）保存图像（如果需要）。if save_path:img.save(save_path)print(f"图像已保存到: {save_path}")# 显示图像。plt.figure(figsize=(8, 8))plt.imshow(img)plt.axis('off')plt.title("生成的图像")plt.show()return Trueexcept Exception as e:print(f"下载/显示图像失败: {e}")return Falsedef print_history_summary(history, server_url="http://127.0.0.1:8188", show_images=True):"""打印历史记录摘要并显示图像参数:history: 历史记录字典server_url: ComfyUI服务器地址show_images: 是否显示图像"""if not history:print("没有可用的历史记录")returnprint(f"\n{'='*50}")print(f"发现 {len(history)} 条历史记录")print(f"{'='*50}")for i, (prompt_id, task) in enumerate(history.items()):# 历史记录提取状态。status = "已完成" if task['status']['completed'] else "未完成"# 收集图像信息。image_urls = []if 'outputs' in task:for node_id, node_output in task['outputs'].items():if 'images' in node_output:for image in node_output['images']:# 构建图像访问 URL。image_url = f"{server_url}/view?filename={image['filename']}&type=output"image_urls.append(image_url)print(f"\n记录 #{i+1}:")print(f"├─ Prompt ID: {prompt_id}")print(f"├─ 状态: {status}")print(f"├─ 生成图像: {len(image_urls)} 张")# 显示图像。if show_images and image_urls:print("├─ 正在显示图像...")# 只显示第一张图像（避免显示太多）。image_url = image_urls[0]save_path = os.path.join(images_dir, f"{prompt_id}.png")# 下载并显示图像。if download_image(image_url, save_path):print(f"├─ 显示完成: {image_url}")else:print("├─ 图像显示失败")# 如果有更多图像，只显示 URL。if len(image_urls) > 1:print(f"├─ 其他图像URL ({len(image_urls)-1}张):")for j, url in enumerate(image_urls[1:3]): # 最多显示 2 张额外 URL。print(f"│ ├─ 图像 {j+2}: {url}")if len(image_urls) > 3:print(f"│ └─ ...还有 {len(image_urls)-3} 张图片")elif image_urls:# 如果不显示图像，只显示 URL。print("├─ 图像URL:")for j, url in enumerate(image_urls[:3]): # 最多显示 3 张图片的 URL。print(f"│ ├─ 图像 {j+1}: {url}")if len(image_urls) > 3:print(f"│ └─ ...还有 {len(image_urls)-3} 张图片")else:print("├─ 图像: 无")# 使用示例。if __name__ == "__main__":server_address = "http://sdxxxxxxxxxxpjg.apigateway-cn-beijing.volceapi.com" #替换为您自己 ComfyUI 应用的访问地址。# 获取所有历史记录。history = get_comfyui_history(server_url=server_address, max_entries=1)# 打印摘要并显示图像。print_history_summary(history, server_url=server_address, show_images=True)# 可选：保存完整的历史记录到文件。comfyui_history = os.path.join(script_dir, "comfyui_history.json")with open(comfyui_history, 'w') as f:json.dump(history, f, indent=2)print("\n完整历史记录已保存到 comfyui_history.json")
ComfyUI 应用页面无法查看日志信息怎么办？
ComfyUI 应用的日志信息与应用关联的 API 网关实例的 Upstream Ingress 相关。Upstream Ingress 关联的路由匹配规则 Method 需包含 Patch。
最近更新时间：2026.01.14 17:39:04
这个页面对您有帮助吗？
有用
有用
无用
无用