> ## Documentation Index
> Fetch the complete documentation index at: https://api-doc.vncps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI 集成概览

> 在 ComfyUI 中使用豆包大模型和 Gemini 的完整指南

## 欢迎使用 ComfyUI 自定义节点

本文档提供了在 ComfyUI 中集成豆包大模型（Seedance、Seedream）和 Gemini 的完整使用指南。

<CardGroup cols={5}>
  <Card title="Seedance 视频生成" icon="video" href="/comfyui/seedance">
    调用豆包 Seedance API 生成视频
  </Card>

  <Card title="Seedream 图片生成" icon="image" href="/comfyui/seedream">
    调用豆包 Seedream API 生成图片
  </Card>

  <Card title="Gemini Banana 图片生成" icon="wand-magic-sparkles" href="/comfyui/gemini">
    使用 Gemini Banana 进行文生图、图生图和多图融合
  </Card>

  <Card title="Gemini 3.1 Flash" icon="bolt" href="/comfyui/gemini-3-1-flash">
    使用 artsmpc-gemini-3.1 节点进行智能图像生成
  </Card>

  <Card title="Nano Banana 图片生成" icon="image" href="/comfyui/nano-banana">
    使用 Nano Banana 进行文生图、图生图和多图参考
  </Card>
</CardGroup>

***

## 前置准备：获取 API Key

### API Key 获取步骤

<img src="https://mintcdn.com/shihuo/CnGWWHK8mACs6OBM/images/tianjialingpai.png?fit=max&auto=format&n=CnGWWHK8mACs6OBM&q=85&s=898d28e712a6e847b21703fead2cc935" alt="控制台-令牌管理界面" width="1907" height="616" data-path="images/tianjialingpai.png" />

**操作流程：**

<Steps>
  <Step title="登录 API 站">
    访问 API 控制台登录您的账号
  </Step>

  <Step title="进入令牌管理">
    导航至 **控制台** → **令牌管理**
  </Step>

  <Step title="添加令牌">
    点击 **添加令牌** 按钮创建新的 API Key
  </Step>

  <Step title="获取密钥">
    查看已创建的令牌，点击右侧 👁️(查看)或 📋(复制)图标获取密钥
  </Step>

  <Step title="配置到节点">
    将获取的 API Key 配置到 ComfyUI 节点中
  </Step>
</Steps>

<Warning>
  **重要提示：**

  * 令牌创建后请妥善保管，避免泄露
  * 可以设置令牌的剩余额度和总额度进行管理
  * 不同功能(Seedance视频生成、Seedream图片生成)可使用同一令牌
</Warning>

***

## 节点在 ComfyUI 中的使用

### 查找节点

<img src="https://mintcdn.com/shihuo/hVLKrJhplDfKw17q/images/comfyui-nodes-search.png?fit=max&auto=format&n=hVLKrJhplDfKw17q&q=85&s=f780ea024f06dc8e7b27b0b8d22f5ede" alt="ComfyUI 节点搜索界面" width="585" height="420" data-path="images/comfyui-nodes-search.png" />

**使用步骤：**

1. 在节点库中搜索 `artsmcp`
2. 展开 `artsmcp` 文件夹(包含 4 个节点)
3. 选择需要的节点拖拽到工作区

<Info>
  **节点布局说明：**

  * 上方搜索框：显示搜索结果列表
  * 下方文件夹：展示 artsmcp 包中的所有节点
  * 可直接点击节点添加到工作流
</Info>

***

## 可用节点列表

### 节点标识对照表

| 节点功能                       | 节点标识                    | 技术栈              | 文档链接                              |
| -------------------------- | ----------------------- | ---------------- | --------------------------------- |
| **视频生成**                   | `artsmcp-seedance`      | artsmcp-seedance | [查看详情](/comfyui/seedance)         |
| **图片生成**                   | `artsmcp-seedream`      | artsmcp-seedream | [查看详情](/comfyui/seedream)         |
| **图片生成（Gemini Banana）**    | `artsmcp-gemini-banana` | Gemini           | [查看详情](/comfyui/gemini)           |
| **图片生成（Gemini 3.1 Flash）** | `artsmpc-gemini-3.1`    | Gemini 3.1 Flash | [查看详情](/comfyui/gemini-3-1-flash) |

## 模型映射关系

| 内部代号                | 官方/API 名称                        | 对应节点                    | 特点                 |
| ------------------- | -------------------------------- | ----------------------- | ------------------ |
| **Nano Banana 2**   | `gemini-3.1-flash-image-preview` | `artsmpc-gemini-3.1`    | 主打速度与主流高质量，目前的默认模型 |
| **Nano Banana Pro** | `gemini-3-pro-image-preview`     | `artsmcp-gemini-banana` | 主打极致质量，Pro/高级选项    |

<Info>
  提供 **Nano Banana**、**Gemini Banana**、**Seedance**、**Seedream** 四类节点，覆盖图片与视频生成全流程。
  Nano Banana 详细参数说明见根目录 `README.md` 或本节的 Nano Banana 文档。
</Info>

***

## 常见问题

<AccordionGroup>
  <Accordion title="如何获取 API Key？">
    访问 API 控制台的令牌管理页面，创建新的令牌即可获取 API Key。详见[前置准备](#前置准备获取-api-key)部分。
  </Accordion>

  <Accordion title="节点找不到怎么办？">
    1. 确保已安装 artsmcp 插件包
    2. 在节点搜索框中输入 `artsmcp`
    3. 重启 ComfyUI 后重试
  </Accordion>

  <Accordion title="生成失败如何调试？">
    开启节点的"调试模式"参数，查看详细的错误日志信息，检查：

    * API Key 是否正确
    * API 地址是否可访问
    * 参数配置是否符合要求
  </Accordion>

  <Accordion title="多个节点可以共用 API Key 吗？">
    可以。Seedance、Seedream 和其他豆包系列节点可以使用同一个 API Key。
  </Accordion>
</AccordionGroup>

***

## 快速开始

<Steps>
  <Step title="安装插件">
    在 ComfyUI 中安装 artsmcp 插件包
  </Step>

  <Step title="获取 API Key">
    按照上述步骤在控制台创建并获取 API Key
  </Step>

  <Step title="选择节点">
    根据需求选择对应的节点
  </Step>

  <Step title="配置参数">
    在节点中配置 API Key 和其他必要参数
  </Step>

  <Step title="开始使用">
    连接工作流并开始生成内容
  </Step>
</Steps>

***

## 相关资源

<CardGroup cols={2}>
  <Card title="图片生成 API 文档" icon="image" href="/api-reference/image-generation">
    查看 Seedream API 的详细文档
  </Card>

  <Card title="视频生成 API 文档" icon="video" href="/api-reference/video-generation">
    查看 Seedance API 的详细文档
  </Card>

  <Card title="API 使用指南" icon="book" href="/api-reference/introduction">
    了解 API 的基础使用方法
  </Card>

  <Card title="快速开始" icon="rocket" href="/quickstart">
    快速上手 API 使用
  </Card>
</CardGroup>