API 节点

定位

API 节点将云端模型或外部服务接入 ComfyUI 工作流。本地节点负责组织输入、处理结果和连接后续步骤，实际模型推理由远程服务执行。

适用情况：

本机显存不足。
模型只提供云端 API。
临时使用高显存或专用模型。
将远程结果接入本地后处理流程。

与本地模型的区别

项目	本地节点	API 节点
计算位置	本机	远程服务
主要限制	显存、内存和速度	网络、额度、费用和服务状态
模型版本	本地自行管理	由服务提供方管理
数据范围	通常留在本机	输入会发送到外部服务

工作流

API 节点仍然遵循输入、参数和输出的数据流：

md

提示词 / 图片
↓
API 节点
↓
IMAGE / VIDEO / AUDIO
↓
本地保存或后处理

提交批量任务前，应先用少量输入验证参数、返回类型、费用和失败重试行为。

凭据

API 密钥仅保存在 ComfyUI 的凭据配置或环境变量中。
不将密钥写入工作流 JSON、节点文本框、提示词或文件名。
分享工作流前检查节点属性和导出文件。
不使用来历不明的自定义节点处理凭据。

成本与隐私

明确服务的计费单位，例如次数、分辨率、时长或计算量。
批量大小与重试可能产生重复费用。
上传人物、客户素材或未公开内容前检查服务隐私条款。
外部服务变更模型版本后，相同工作流不一定能完全复现结果。

排查

检查网络、API 密钥和账户额度。
检查请求参数是否满足服务限制。
查看 ComfyUI 日志中的 HTTP 状态和错误信息。
使用最小输入单独运行 API 节点。
确认返回数据类型与下游节点匹配。