ComfyUI-YCYY-API

English | 中文

在 ComfyUI 中自由的调用 API

使用说明

在 ComfyUI 中进入你的 custom_nodes 文件夹，打开终端并运行以下命令：

git clone https://github.com/ycyy/ComfyUI-YCYY-API.git

复制 config.json.example 文件并重命名为 config.json。然后修改对应的 base_url 和 api_key
启动 ComfyUI 找到 YCYY/API 节点目录开始体验吧

配置文件说明

gemini-image

base_url 同时支持官方和第三方兼容接口根据实际情况配置，路径以 v1beta/models 结尾。models 支持 gemini-2.5-flash-image、gemini-3-pro-image-preview 模型。如果使用第三方接口，模型名称根据实际情况修改。

ollama-vlm 和 ollama-llm

base_url 同时支持本地和 ollama 云服务接口，根据实际情况配置，接口为 OpenAI 兼容格式。配置文件的模型为官方云服务支持的模型，可以根据需要进行修改。如果调用本地接口没有配置 api_key 则可以不填写该选项。

modelscope-image

modelscope-image 使用数组配置多个魔搭图片 API name。图片生成和图片编辑共用一个节点：不连接 image 时生成图片，连接 image 时编辑图片。建议分别创建生成和编辑两个 api-name，并在各自的 models 中配置对应类型的模型；切换 api-name 后节点会同步更新模型列表。

旧版单对象 modelscope-image 配置仍可使用，其 api name 显示为 default。原 modelscope-image-edit 配置需要迁移为 modelscope-image 数组中的独立配置项。通常只需要填写对应的 api_key，其他官方接口参数保持示例值即可。

openai-text

openai-text 使用数组配置多个 OpenAI 或兼容接口。每项包含 api-name、base_url、api_key、timeout、api_protocol 和 models。api_protocol 支持 openai-completions 与 openai-responses。

base_url 可以填写根地址（例如 https://api.openai.com/v1），节点会按协议追加 /chat/completions 或 /responses；也可以直接填写对应完整端点。完整端点与协议不匹配时会报错。API Config Options 只覆盖显式提供的值：base_url 和 api_key 留空、api_protocol=inherit、timeout=0 时，使用所选 API 的原配置。

节点支持文本、图像和视频输入。视频会按当前协议的格式直接发送；如果目标 API 或协议不支持视频，接口错误会转换为明确的视频不支持提示。files 输入当前版本暂不支持。OpenAI 文本高级选项（JSON） 节点接受协议或 API 特有参数，例如 {"temperature":0.7,"max_output_tokens":4096}。JSON 参数不能覆盖 model、messages、input、instructions、stream、api_key、base_url 或 timeout 等请求字段。

启用 stream 后，模型响应会通过服务器发送事件（SSE）在生成过程中流式传输到客户端，也支持与 skill_options 同时使用。在 Skill 模式中，包含工具调用的轮次产生的文本只作为候选内容；工具调用完成后会丢弃该轮候选文本，只有“不再调用工具”的轮次才会提升为最终答案。最终的 end 事件具有权威性，并会校准流式增量与节点最终输出之间的差异。终止状态会区分正常完成、输出截断和错误。

skills

OpenAI 文本 Skill 选项 节点可以发现以 SKILL.md 组织的本地 Skill。选择 Skill 后，通过 skill_options 连接到 OpenAI 文本 API 节点。使用 skills.paths 配置 Skill 位置；相对路径以本插件目录为基准，默认位置为 skills/。将 skills.allow_call 设置为 true 后即可启用 Skill 调用。

运行时，模型会遵循所选 Skill 的说明，并按需读取其中的文本资源。脚本文件只能作为文本读取，不会被执行。Skill 模式不能运行命令、编辑或写入文件，也不能自行访问网络。目标模型服务需要支持工具调用。

Skill 流式输出采用稳妥策略：按模型轮次缓冲候选文本；发生工具调用的轮次会清空候选内容；只有无工具调用且正常结束的轮次才会显示为最终文本。这样可以避免模型读取 Skill 资源后修改答案时，前端先展示错误的中间答案。

proxy

proxy 支持配置http代理，适用于特殊网络环境

高级使用说明

API节点支持 Config Options 和 Proxy Options。均可以通过前台节点配置参数实现覆盖配置文件参数的功能。

4.5 KiB Raw Permalink Blame History Unescape Escape