Gemini Imagen 接入指南

开发流程仅供参考

📋 概述

本文档说明如何在现有 AI 绘画系统中接入 Google Gemini Imagen 3 (Nano Banana) 图片生成接口。

✅ 已完成的修改

1. 后端文件修改（7个文件）

1.1 新增引擎实现

✅ server/app/common/service/draw/engine/DrawGemini.php - Gemini 绘画引擎

1.2 枚举定义

✅ server/app/common/enum/draw/DrawEnum.php

添加 API_GEMINI = 'gemini' 常量

更新 getAiModelName() 方法

更新 getDrawChannel() 方法

添加 Gemini 默认配置

1.3 驱动层

✅ server/app/common/service/draw/DrawDriver.php

添加 drawGeminiConfig() 方法

更新构造函数的 match 语句

1.4 队列服务

✅ server/app/common/service/draw/QueueService.php

添加 pushGemini() 方法

添加 GEMINI_JOB 常量

1.5 队列任务

✅ server/app/queue/GeminiQueueJob.php - Gemini 队列处理任务

1.6 业务逻辑

✅ server/app/api/logic/draw/DrawLogic.php

更新 drawImagineHandle() 方法的 match 语句

添加 notifyGemini() 回调处理方法

2. 前端文件修改（5个文件）

2.1 枚举定义

✅ pc/src/pages/draw/enums/DrawEnum.ts

添加 GEMINI = 'gemini' 枚举值

更新 DrawLink 路由映射

2.2 页面组件

✅ pc/src/pages/draw/gemini.vue - Gemini 绘画主页面

2.3 专用组件

✅ pc/src/pages/draw/components/gemini/gemini-style.vue - 风格选择

✅ pc/src/pages/draw/components/gemini/gemini-picture-size.vue - 尺寸选择

🔧 配置步骤

1. 获取 Gemini API Key

访问 Google AI Studio

创建 API Key

复制 API Key 备用

2. 后台配置

登录管理后台

进入 AI应用 > 绘画设置

找到 Gemini绘图 配置项

填写以下信息：

状态: 开启

API Key: 粘贴你的 Gemini API Key

代理地址: (可选) 如需使用代理，填写代理地址

消耗电量: 设置每次绘画消耗的电量值

翻译设置: 配置提示词翻译方式

3. Key Pool 配置

在 cw_key_pool 表中添加 Gemini API Key：

参数说明：

type: 2 表示绘画类型

platform: 'gemini'

status: 1 表示启用

4. 前端路由配置

在 Nuxt 路由配置中添加 Gemini 页面路由（如果使用自动路由则无需配置）：

5. 权限配置

在管理后台的菜单管理中添加 Gemini 绘画菜单项。

📝 API 接口说明

Gemini API 特点

端点: https://generativelanguage.googleapis.com/v1beta/models/imagen-3.0-generate-001:predict

认证方式: API Key (通过 URL 参数传递)

请求格式: JSON

响应格式: Base64 编码的图片

请求参数

{
  "instances": [
    {
      "prompt": "提示词",
      "image": {
        "bytesBase64Encoded": "base64图片" // 图生图时使用
      }
    }
  ],
  "parameters": {
    "sampleCount": 1,
    "aspectRatio": "1024x1024",
    "negativePrompt": "反向提示词",
    "mode": "foreground", // 可选: foreground, background, product
    "safetySetting": "block_some"
  }
}

响应格式

{
  "predictions": [
    {
      "bytesBase64Encoded": "base64编码的图片数据",
      "mimeType": "image/png"
    }
  ]
}

🎨 功能特性

支持的功能

✅ 文生图: 根据文字描述生成图片

✅ 图生图: 基于参考图生成新图片

✅ 反向提示词: 指定不想出现的内容

✅ 多种尺寸: 1024x1024, 1536x1536, 1024x1536, 1536x1024

✅ 生成模式: 前景、背景、产品模式

✅ 提示词翻译: 支持中文提示词自动翻译

✅ 内容审核: 自动审核生成的图片

✅ VIP权益: 支持VIP免费绘画

不支持的功能

❌ 图片放大: Gemini 暂不支持图片放大功能

❌ 图片变换: Gemini 暂不支持图片变换功能

❌ 局部重绘: Gemini 暂不支持局部重绘

🔄 业务流程

用户提交绘画请求
    ↓
DrawController::drawing()
    ↓
DrawLogic::draw()
    ├→ 参数验证
    ├→ 敏感词检测
    ├→ 提示词翻译
    ├→ 创建记录
    ├→ 扣除电量
    └→ 提交队列
        ↓
QueueService::pushGemini()
    ↓
GeminiQueueJob::fire()
    ↓
DrawDriver::imagine()
    ↓
DrawGemini::imagine()
    ├→ 构建请求参数
    ├→ 调用 Gemini API
    └→ 返回响应
        ↓
DrawLogic::notifyGemini()
    ├→ 解析 Base64 图片
    ├→ 保存到本地
    ├→ 上传到云存储
    ├→ 生成缩略图
    ├→ 内容审核
    └→ 更新记录状态
        ↓
前端轮询获取结果

🧪 测试步骤

1. 后端测试

2. 前端测试

访问 /draw/gemini

输入提示词: "一只可爱的猫咪"

选择尺寸: 1024x1024

点击生成按钮

等待生成结果

3. 验证清单

API Key 配置正确

队列任务正常执行

图片生成成功

图片保存到正确位置

缩略图生成成功

内容审核正常

电量扣除正确

VIP权益生效

前端显示正常

⚠️ 注意事项

1. API 限制

速率限制: Gemini API 有请求频率限制，建议配置队列延迟

超时时间: 图片生成可能需要 60-120 秒，已设置超时为 120 秒

并发限制: 建议控制并发请求数量

2. 成本控制

Gemini API 按请求计费，建议设置合理的电量消耗值

可以为 VIP 用户提供免费额度

建议启用内容审核，避免生成违规内容

3. 错误处理

API 错误会自动重试 3 次

失败后会自动退还用户电量

错误信息会记录到 fail_reason 字段

4. 安全设置

已启用 safetySetting: 'block_some' 安全过滤

建议配置敏感词过滤

建议启用图片内容审核

🔍 故障排查

问题 1: API Key 无效

症状: 提示 "请在后台配置 Gemini API Key"

解决方案:

检查 Key Pool 配置

确认 API Key 正确

检查 API Key 状态是否启用

问题 2: 请求超时

症状: 提示 "请求超时"

解决方案:

增加超时时间配置

检查网络连接

考虑使用代理

问题 3: 图片保存失败

症状: 提示 "Gemini绘图保存失败"

解决方案:

检查目录权限

检查云存储配置

查看错误日志

问题 4: 队列不执行

症状: 任务一直处于"执行中"状态

解决方案:

检查队列服务是否启动

查看队列日志

手动执行队列任务

📚 参考资料

Google Gemini API 文档

Imagen 3 模型说明

API 定价

🎉 总结

通过以上步骤，你已经成功将 Google Gemini Imagen 3 接入到现有的 AI 绘画系统中。整个接入过程：

✅ 架构兼容: 完全兼容现有架构，无需大改

✅ 代码复用: 复用了大量现有代码和组件

✅ 功能完整: 支持文生图、图生图、提示词翻译等核心功能

✅ 易于维护: 代码结构清晰，易于后续维护和扩展

如有问题，请参考故障排查部分或查看系统日志。

📋 概述#

✅ 已完成的修改#

1. 后端文件修改（7个文件）#

1.1 新增引擎实现#

1.2 枚举定义#

1.3 驱动层#

1.4 队列服务#

1.5 队列任务#

1.6 业务逻辑#

2. 前端文件修改（5个文件）#

2.1 枚举定义#

2.2 页面组件#

2.3 专用组件#

🔧 配置步骤#

1. 获取 Gemini API Key#

2. 后台配置#

3. Key Pool 配置#

4. 前端路由配置#

5. 权限配置#

📝 API 接口说明#

Gemini API 特点#

请求参数#

响应格式#

🎨 功能特性#

支持的功能#

不支持的功能#

🔄 业务流程#

🧪 测试步骤#

1. 后端测试#

2. 前端测试#

3. 验证清单#

⚠️ 注意事项#

1. API 限制#

2. 成本控制#

3. 错误处理#

4. 安全设置#

🔍 故障排查#

问题 1: API Key 无效#

问题 2: 请求超时#

问题 3: 图片保存失败#

问题 4: 队列不执行#

📚 参考资料#

🎉 总结#

📋 概述

✅ 已完成的修改

1. 后端文件修改（7个文件）

1.1 新增引擎实现

1.2 枚举定义

1.3 驱动层

1.4 队列服务

1.5 队列任务

1.6 业务逻辑

2. 前端文件修改（5个文件）

2.1 枚举定义

2.2 页面组件

2.3 专用组件

🔧 配置步骤

1. 获取 Gemini API Key

2. 后台配置

3. Key Pool 配置

4. 前端路由配置

5. 权限配置

📝 API 接口说明

Gemini API 特点

请求参数

响应格式

🎨 功能特性

支持的功能

不支持的功能

🔄 业务流程

🧪 测试步骤

1. 后端测试

2. 前端测试

3. 验证清单

⚠️ 注意事项

1. API 限制

2. 成本控制

3. 错误处理

4. 安全设置

🔍 故障排查

问题 1: API Key 无效

问题 2: 请求超时

问题 3: 图片保存失败

问题 4: 队列不执行

📚 参考资料

🎉 总结