AionUi Image Generation Tool Model Configuration Guide Chinese

AionUi 图像处理工具模型配置指南

本指南将帮助您配置多种图像生成模型：

1. Gemini 官方 2.5 Flash Image Preview 模型配置
2. OpenRouter 平台付费图像模型配置
3. 模型选择与使用建议

English | 简体中文

---

一、Gemini 官方图像模型配置（推荐）

1.1 获取 Gemini API Key

1. 访问 Google AI Studio：https://aistudio.google.com/
2. 使用 Google 账号登录。
3. 在 API Keys 页面创建新的 API Key。

1.2 在 AionUi 绑定 Gemini

1. 打开 AionUi → 设置 → 大模型设置。
2. 新增模型，平台选择「Gemini」。
3. 输入 Gemini API Key 并保存。

1.3 配置 Gemini 图像模型

1. 打开 AionUi → 设置 → 工具配置 → 生图工具。
2. 从 Gemini 平台中选择支持图像生成的模型（如 gemini-2.5-flash-image-preview）。
3. 如果 Gemini 平台没有图像模型，系统会自动添加 gemini-2.5-flash-image-preview 作为默认选项。
4. 确认模型支持图像生成功能后保存配置。

---

二、OpenRouter 平台图像模型配置

2.1 获取 OpenRouter API Key

1. 访问 https://openrouter.ai/，使用 Google / GitHub / 邮箱注册并登录。
2. 打开 Keys 页面：https://openrouter.ai/keys。
3. 点击「Create Key」，给密钥起名（如「AionUi」），创建后复制保存（只显示一次）。

重要提示：OpenRouter 平台上的大部分图像模型需要购买积分使用。不过，系统会自动为您添加 google/gemini-2.5-flash-image-preview 作为免费选项（如果平台中没有其他图像模型）。

2.2 在 AionUi 绑定 OpenRouter

1. 打开 AionUi → 设置 → 大模型设置。
2. 新增模型，平台选择「OpenRouter」。
3. 将上一步复制的 API Key 粘贴进密钥输入框，保存。

2.3 配置图像模型

1. 打开 AionUi → 设置 → 工具配置 → 生图工具。
2. 在模型选择处，从 OpenRouter 平台中选择带有图像生成能力的模型：
   • 查找包含 image、dall-e、midjourney、stable-diffusion、flux、diffusion、imagen 等关键词的模型
   • 如果 OpenRouter 平台没有图像模型，系统会自动添加 google/gemini-2.5-flash-image-preview 作为免费选项
   • 选择适合您需求的图像生成模型
   • 注意查看模型的价格和使用限制

---

三、验证配置成功

1. 回到聊天，选择支持工具调用的大模型开启新会话。
2. 输入「你有哪些工具？」应能看到包含 image-generation 的工具列表。
3. 尝试下发生图指令，例如：「生成一张 1024×1024 的蓝色霓虹赛博朋克城市夜景」以验证。

---

四、常见问题

4.1 模型选择建议

在生图工具设置中，您需要选择一个图像模型。根据您的需求选择合适的模型：

按质量选择：

• 高质量：推荐 gemini-2.5-flash-image-preview（Gemini 官方，免费）
• 专业级：选择 DALL-E 系列、Midjourney 等商业模型（需付费）
• 开源模型：选择 Stable Diffusion、Flux 系列等开源模型

按速度选择：

• 快速生成：选择 Gemini 图像模型、Flux 系列等
• 标准速度：大多数商业图像生成模型

按成本选择：

• 免费选项：gemini-2.5-flash-image-preview（Gemini 官方）或 google/gemini-2.5-flash-image-preview（OpenRouter）
• 预算充足：选择商业图像生成模型获得最佳质量（DALL-E、Midjourney 等）
• 平衡性价比：选择性价比高的图像生成模型（Flux、Stable Diffusion 等）

4.2 配置问题

• API Key 无效：检查密钥是否正确复制，是否已激活
• 模型不可用：确认模型名称正确，平台配置无误
• 生成失败：检查网络连接，确认账户余额充足

4.3 使用问题

• 工具不显示：确认已正确配置图像模型，重启 AionUi 后重试
• 生成质量差：尝试调整提示词描述，或更换其他图像模型
• 生成速度慢：选择生成速度较快的模型，或检查网络连接

4.4 平台支持说明

当前支持的平台：

• Gemini：官方 Gemini 平台，支持 gemini-2.5-flash-image-preview 等图像模型
• OpenRouter：支持多种图像生成模型（DALL-E、Midjourney、Flux、Stable Diffusion 等）
• New API：如果 New API 网关提供的模型中有图像生成模型，也可以使用
• 自定义平台：任何通过自定义平台配置的、模型名称包含图像生成关键词的模型都可以使用

支持的图像模型关键词： 系统会自动识别包含以下关键词的模型名称：flux、diffusion、stabilityai、sd-、dall、cogview、janus、midjourney、mj-、imagen、image 等。

自动添加机制：

• Gemini 平台：如果没有图像模型，系统会自动添加 gemini-2.5-flash-image-preview
• OpenRouter 平台：如果没有图像模型，系统会自动添加 google/gemini-2.5-flash-image-preview 作为免费选项

我们正在持续开发更多平台的支持，包括 ModelScope、Hugging Face 等开源模型平台，敬请期待！

---

五、参考链接

• OpenRouter：https://openrouter.ai/ | https://openrouter.ai/models
• Google AI Studio：https://aistudio.google.com/
• AionUi 官方文档：查看最新配置说明