> ## 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.
# Gemini 3.1 Flash 图片生成节点
> 在 ComfyUI 中使用 artsmpc-gemini-3.1 节点进行图像生成
## 节点概述
**节点标识：** `artsmpc-gemini-3.1`\
**内部代号：** Nano Banana 2\
**官方名称：** `gemini-3.1-flash-image-preview`\
**功能：** 调用 artsmpc API 进行基于参考图像的智能图像生成
**特点：** 主打速度与主流高质量，目前的默认模型
## 模型映射关系
| 内部代号 | 官方/API 名称 | 特点 |
| ------------------- | -------------------------------- | ------------------ |
| **Nano Banana 2** | `gemini-3.1-flash-image-preview` | 主打速度与主流高质量，目前的默认模型 |
| **Nano Banana Pro** | `gemini-3-pro-image-preview` | 主打极致质量，Pro/高级选项 |
### 核心特性
* ✅ **智能构图**：AI 自动选择最佳拍摄角度和画面构图
* ✅ **多图参考**：支持最多 14 张参考图片输入
* ✅ **高质量输出**：支持 4K 分辨率，1:1 宽高比
* ✅ **连贯性保证**：确保光影、色彩、环境演进的一致性
* ✅ **批量生成**：支持并发请求和轮询机制
***
## 节点界面
***
## 参数说明
### 基础配置参数
| 参数名称 | 类型 | 必填 | 说明 | 示例值 |
| --------- | ------ | -- | -------- | -------------------------------- |
| `API地址` | STRING | ✅ | API 服务端点 | `https://api.xxx.com` |
| `查询API地址` | STRING | ✅ | 任务状态查询地址 | `https://task.xxx.com` |
| `API密钥` | STRING | ✅ | 身份验证密钥 | `sk-xxx` |
| `模型` | ENUM | ✅ | 选择模型 | `gemini-3.1-flash-image-preview` |
### 图像生成参数
| 参数名称 | 类型 | 默认值 | 说明 | 可选值 |
| ------- | ---- | ----- | --------- | ------------------------- |
| `宽高比` | ENUM | `1:1` | 输出图像比例 | `1:1` / `16:9` / `9:16` 等 |
| `分辨率` | ENUM | `4K` | 图像分辨率 | `1K` / `2K` / `4K` |
| `并发请求数` | INT | `1` | 同时发起的请求数量 | `1-10` |
### 性能与重试参数
| 参数名称 | 类型 | 默认值 | 说明 | 范围 |
| -------- | --- | ----- | -------- | -------- |
| `超时秒数` | INT | `120` | 单次请求超时时间 | `30-600` |
| `最大重试次数` | INT | `3` | 失败重试次数 | `0-10` |
| `轮询间隔秒数` | INT | `5` | 任务状态查询间隔 | `1-30` |
| `最大轮询次数` | INT | `120` | 最大轮询次数 | `10-500` |
### 输入端口
| 端口名称 | 类型 | 说明 |
| ------------- | ------ | ---------------- |
| `参考图片1-14` | IMAGE | 可选的参考图像输入（最多14张） |
| `description` | STRING | 图像生成的详细描述和要求 |
***
## 使用说明
### 基础使用流程
1. **连接参考图像**：将加载的图像节点连接到 `参考图片1` 端口
2. **配置参数**：设置 API 密钥、分辨率等基础参数
3. **添加描述**：在 `description` 字段中详细说明生成要求
4. **执行生成**：运行工作流等待结果输出
### description 字段建议格式
```
📌 节点说明：gemini-3.1-flash-image-preview
用于根据上传的参考图像（支持最多14张）生成风格统一、镜头连贯的AI图像。
✅ 建议：
- 提供清晰、有层次感的参考图
- 详细描述期望的画面风格和构图要求
- 指定具体的光影和色彩偏好
⚠️ 注意：
- 避免重复构图
- 确保光照与环境一致性
- 建议一次性提供完整的场景参考
🖼️ 输出规格：
- 分辨率：4K (3840×3840)
- 宽高比：1:1
- 自动优化镜头角度与景深
```
***
## 使用示例
### 示例 1：古风角色场景生成
上传一张古装人物的高质量参考图到 `参考图片1`
* 分辨率：`4K`
* 宽高比：`1:1`
* 并发请求数：`3`
```
生成古风场景中的角色画面，要求：
- 保持服装和人物特征的一致性
- 自然的光影效果，柔和的晨光或夕阳
- 背景为古典园林或宫廷场景
- 确保色彩搭配和谐统一
- 避免重复的拍摄角度
```
运行节点，输出 3 张不同角度的古风场景图
### 示例 2：多角度产品展示
上传产品的正面、侧面、背面等多个角度参考图
* 参考图片1：正面视图
* 参考图片2：侧面视图
* 参考图片3：45度角视图
* 分辨率：`4K`
* 宽时比：`1:1`
* 并发请求数：`5`
```
基于提供的多角度参考图，生成产品的精美展示图：
- 保持产品外观和质感的一致性
- 专业的摄影布光效果
- 简洁干净的背景
- 突出产品的设计特点
- 每张图展现不同的展示角度
```
得到 5 张专业级的产品展示图像
***
## 最佳实践
### 参考图准备建议
* **质量优先**：使用高分辨率、清晰的参考图
* **多样性**：提供不同角度、光照条件的参考
* **一致性**：确保参考图风格和主题统一
* **数量适中**：根据需求提供 3-8 张参考图效果最佳
### 描述文本编写技巧
* **具体明确**：避免模糊的描述词汇
* **分点说明**：使用列表形式清晰表达要求
* **技术细节**：包含光影、色彩、构图等专业要求
* **约束条件**：明确指出不希望出现的问题
### 性能优化建议
* **合理设置并发数**：根据系统性能调整并发请求数
* **适当超时设置**：复杂场景可适当延长超时时间
* **轮询参数调优**：根据网络状况调整轮询间隔
***
## 常见问题
* 检查参考图质量和清晰度
* 详细描述中明确指出需要保留的特征
* 尝试提供更多角度的参考图
* 调整描述文本的具体程度
* 使用同一系列风格的参考图
* 在描述中强调一致性要求
* 保持相同的光照和色彩设定
* 减少并发请求数以确保质量
* 检查网络连接是否稳定
* 适当增加超时时间和轮询次数
* 确认 API 密钥和地址配置正确
* 查看是否有服务端限制或维护
* 生成的图片版权归使用者所有
* 商业使用前建议咨询法律专业人士
* 保留生成过程的相关记录
* 注意参考图可能涉及的版权问题
***
## 技术细节
### API 通信机制
节点采用异步任务处理模式：
1. 提交图像生成请求获得任务ID
2. 定期轮询任务状态
3. 任务完成后获取结果URL
4. 下载并输出生成的图像
### 错误处理
* **网络错误**：自动重试机制，指数退避策略
* **API错误**：根据错误码提供具体解决方案
* **超时处理**：可配置的超时和重试参数
* **状态监控**：实时显示任务进度和状态
**性能指标：**
* 平均生成时间：30-120秒
* 成功率：95%以上（网络正常情况下）
* 支持批量处理：最高10个并发请求