容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务AI 云原生推理套件ComfyUI 应用ComfyUI 常见问题
复制全文
下载 pdfComfyUI 常见问题
文档反馈
问问助手本文主要描述 ComfyUI 应用相关的常见问题及其解决方法。
如何给 ComfyUI 应用增加账号登录认证能力？
- 登录 智能体身份和权限控制台。
- 创建用户池。按实际情况，自定义配置参数。详情请参见 创建用户池。
- 创建 Web 客户端。部分参数按如下表说明配置，其余参数按实际情况，自定义配置。详情请参见 创建客户端。
- 参数说明参数说明客户端类型选择 Web 应用。允许回调 URIs填写 ComfyUI 应用的服务域名回调 URI，格式为：https://${ComfyUI服务域名}/callback，例如https://sd5e****.apigateway-cn-beijing.volceapi.com/callback。说明
- 为 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，使用 ServingKit 的加速节点？
您可以按如下表说明，配置 Workflow 中的模块。
模块名称 | 未使用加速节点的 Workflow | 使用加速节点的 Workflow | 说明 |
模块名称 | 未使用加速节点的 Workflow | 使用加速节点的 Workflow | 说明 |
Resource Pool | 无 | 独有模块 | 在您的 Workflow 中增加 Resource Pool 节点，并配置单卡推理。 |
Load Models Here | 通用 UNET 加载器 | OpenVefuser DiT Loader | 将 UNET 加载器改成火山引擎自研的 OpenVefuser 插件进行推理。 |
OpenVefuser Apply FBCache | 无 | 独有模块 | 在您的 Workflow 中增加 FBcache 节点，实现缓存复用。 |
采样器 | K 采样器 | OpenVefuser KSampler | 将 K 采样器改成火山引擎自研的 OpenVefuser 插件进行推理。 |
打开 ComfyUI Workflow 提示模型缺失时如何处理？
根据是否有本地模型文件，使用不同的方式处理：
本地有模型文件
- 下载 TOS 的 tosutil 或者 TOSBrowser 工具，后续管理ComfyUI中节点或输入内容下载均可使用该工具。详情请参见 TOS常用工具概览。
- 获取 API 访问密钥，密钥权限至少包含 TOS 读写权限。详情请参见 API 密钥。
- 登录 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文件示例代码如下所示，根据代码中的注释说明，自定义调整参数示例值。
*
*查询历史记录：创建一个名为history.py的 Python 脚本，执行python3 history.py命令，即可模型的查询历史记录。
*prompt.py文件示例代码如下所示，根据代码中的注释说明，自定义调整参数示例值。
*
*
如何通过 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。
*
*若您已有的 Upstream Ingress 不满足要求，您可以新建 Upstream Ingress 或 API 网关工单 联系技术支持更新已有 Upstream Ingress。
ComfyUI 应用页面无法查看日志信息怎么办？
ComfyUI 应用的日志信息与应用关联的 API 网关实例的 Upstream Ingress 相关。Upstream Ingress 关联的路由匹配规则 Method 需包含 Patch。
最近更新时间：2026.10.14 19:17:57
这个页面对您有帮助吗？
有用
有用
无用
无用