ComfyUI-Jimeng-API
ComfyUI nodes for Volcano Ark (Jimeng) API
Nodes (12)
The key node every Jimeng workflow starts with (and how it saves your keys)
A fake progress bar (and a sneaky time estimator)
A spending cap so a runaway batch doesn't drain your key
Simple multi-image animation on a model that's retiring
The plain, dependable video node that still gets the job done
Draft-first video generation, now with audio
The flagship video node that edits, extends, and hears audio
The old reliable image node, gently on its way out
Reference images, group generation, and the 4.5 upgrade path
The image node with a web search and a brain
The dashboard for everything you've generated
Ask questions about an image or video and get answers
ComfyUI 即梦 API 节点
本项目为 ComfyUI 提供了火山方舟的视觉模型（即梦/豆包） API 节点。用户可以通过这些节点在 ComfyUI 中使用多种图像生成和视频生成功能。
- 项目已支持
Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini与Seedance 2.5；2.0 标准版最高支持 4K，2.5 最长支持 30 秒。 - 如在使用过程中遇到问题，请通过 ISSUES 反馈。
- Classic Canvas 与 Nodes 2.0（Vue）均受支持，最低支持 ComfyUI
0.25.1。
✨ 项目特性
- 多 Key 管理：支持在配置文件中设置多个 API Key，并在节点中灵活切换，方便管理不同账户或配额。
- 异步与并发：所有核心节点均支持任务的异步提交和并发生成，无需阻塞队列，大幅提升批量生成效率。
- 友好交互：提供清晰的控制台进度提示和完善的异常处理机制，报错信息直观，便于快速排查问题。
📦 安装
方式1： 克隆仓库:
打开终端，cd 到 ComfyUI 的 custom_nodes 目录，运行：
git clone https://github.com/fkxianzhou/ComfyUI-Jimeng-API
方式2： 使用ComfyUI Manager下载。
⚙️ 设置：配置 API 密钥
方式 1：手动配置
- 在插件根目录中找到
api_keys.json.example文件。 - 将其重命名为
api_keys.json。 - 打开文件并填入您的密钥信息（从此获取 Key）。
方式 2：节点内配置
- 在 ComfyUI 中添加 Jimeng API Client 节点。
- 在
key_name下拉框中选择 Custom。 - 在弹出的输入框中填入您的 API Key。
- （可选）在
new_key_name中填入一个名称（如 "MyKey"），运行一次后该 Key 将被自动保存。- 注意：保存后需刷新浏览器页面，新密钥才会显示在下拉列表中。
📖 功能节点列表
(所有节点均位于 JimengAI 菜单下)
- 基础设置:
火山方舟 API 客户端: (必须) 用于加载并创建一个可供其他节点使用的客户端实例。Jimeng 配额设置: 用于设置图像和视频生成的配额限制，防止意外消耗过多资源。
- 图像生成:
图像生成（Seedream 3）: 基础图像生成节点。图像生成（Seedream 4）: 高级图像生成节点，支持多图输入、组图生成以及 4.5 模型。图像生成（Seedream 5）: 支持 Seedream 5 Pro/Lite；Pro 提供提示词优化，Lite 支持组图与联网搜索。
- 视频生成:
视频生成（Seedance 1.0）: 核心视频生成节点，支持文生视频、图生视频（首/尾帧）。视频生成（Seedance 1.5 Pro）: 支持音频生成和智能时长的高级视频生成节点。视频生成（Seedance 2 / 2.5）: 支持图片/视频/音频多模态参考、视频编辑/延长与联网搜索增强。视频生成（参考图生视频）: 根据 1-4 张参考图像生成视频。视频生成任务列表查询: 用于查询和管理在 API 上运行的任务历史。
- 视觉理解:
视觉理解（Visual Understanding）: 默认使用 Seed 2.1 Pro，并保留 Seed 2.0 Pro/Lite/Mini 兼容旧工作流。
📑 节点详解
火山方舟 API 客户端 (Jimeng API Client)
加载 api_keys.json 中的密钥配置。这是所有工作流的起点。
- 输入:
密钥名称(在 JSON 中配置的 customName)。 - 输出:
客户端实例。
Jimeng 配额设置 (Jimeng Quota Settings)
允许为当前客户端设置图像（张数）和视频（Tokens）的使用上限。
-
特性: 当达到限额时自动停止任务并抛出提示，防止额度超支。
-
示例工作流（点击预览图打开 JSON）：
图像生成（Seedream 4）
支持 doubao-seedream-4.5 与 doubao-seedream-4.0。
- 输入图像: 支持单张或多张（Batch）图像作为参考。
- 启用组图生成: 开启后可一次性生成多张内容关联的图片。
- 提示词优化: Seedream 4.0 可通过开关启用；Seedream 4.5 不发送此参数。
示例工作流（点击预览图打开 JSON）：
图像生成（Seedream 5）
支持 doubao-seedream-5.0-pro 与 doubao-seedream-5.0-lite。
- Pro: 最多 10 张参考图；保留种子与水印；默认开启提示词优化，使用参考图时必须开启；输出通过 URL 下载。
- Lite: 保留流式 Base64、组图生成、联网搜索与种子功能。
- 自定义尺寸: Pro 要求宽高为 16 的倍数、比例在 1:16–16:1、总像素为 921600–4194304。
示例工作流（点击预览图打开 JSON）：
视频生成（Seedance 1.0/1.5 Pro）
支持文生视频与首/尾帧图生视频；在 1.0 能力基础上，1.5 Pro 支持音效生成与智能时长控制。
示例工作流（点击预览图打开 JSON）：
视频生成（Seedance 2 / 2.5）
可覆盖文生视频、多模态参考生视频、视频编辑、视频延长与联网搜索增强。
- Seedance 2.5: 480p / 720p、4–30 秒；最多 30 张参考图、10 段参考视频和 10 段参考音频，并允许纯音频参考。
- Seedance 2.0 标准版: 480p / 720p / 1080p / 4K、4–15 秒；最多 9 张参考图、3 段参考视频和 3 段参考音频。
- Seedance 2.0 Fast、Mini: 480p / 720p、4–15 秒；参考数量限制与 2.0 标准版相同。
- 参考视频: 最大 200 MB、409600–8295044 像素、24–60 FPS；可识别编码元数据时要求 H.264/H.265 视频与 AAC/MP3 音频。
- 参考媒体时长: Seedance 2.5 单个及同类素材总时长上限为 30.2 秒；Seedance 2.0 系列为 15.2 秒。
- 请求大小: 最终紧凑 UTF-8 JSON 请求体不得超过 64 MiB。
示例工作流（点击预览图打开 JSON）：
视频生成任务列表查询
支持按状态、模型版本或任务 ID 过滤查询任务历史。
视觉理解（Seed 2.1 / 2.0）
默认使用 doubao-seed-2-1-pro，并保留 doubao-seed-2.0 系列模型。
- 多模态输入: 支持上传图片或视频进行理解和问答。
- 多轮对话: 支持开启多轮对话模式，保持上下文。
- 深度思考: 支持开启深度思考模式，提升复杂问题的推理能力。
示例工作流（点击预览图打开 JSON）：
📓 示例工作流
您可以在 example_workflows 目录中找到所有节点的示例工作流。
🧩 ComfyUI 兼容性
| ComfyUI / 前端 | Classic Canvas | Nodes 2.0 | 说明 | |---|---:|---:|---| | 0.25.1 / 1.45.15 | 支持 | 支持 | 最低支持版本；包含旧平铺工作流迁移 | | 0.28.0 / 1.45.21 | 支持 | 支持 | 官方稳定分支目标 | | 前端 1.46.3+ | 支持 | 支持 | 已覆盖 DynamicCombo 保存与恢复路径 |