Best Image Generation

核心用法

best-image-generation 是一个调用 EvoLink Nano Banana Pro (gemini-3-pro-image-preview) 模型的图像生成技能，通过 REST API 实现：

• 文生图：直接输入 prompt，指定尺寸（auto/1:1/16:9 等）和画质（1K/2K/4K）
• 图生图/编辑：提供最多 10 张参考图片 URL（≤10MB，jpg/png/webp），结合 prompt 进行重绘或编辑
• 异步工作流：提交任务 → 轮询状态（每10秒，最多12分钟）→ 下载结果

关键参数

| 参数 | 说明 |

|------|------|

| `size` | 支持 11 种比例，auto 自适应 |

| `quality` | 2K 默认，4K 额外计费 |

| `image_urls` | 图生图时最多 10 张参考图 |

输出文件自动保存为 evolink-<时间戳>.<格式>，并打印 MEDIA:<路径> 供 OpenClaw 自动附加。

显著优点

1. 性价比突出：单张 $0.12-0.20，低于 Midjourney/DALL-E 3 等主流服务
2. 多模态支持：原生支持文本+图像混合输入，编辑场景灵活
3. 高分辨率选项：最高 4K 输出，满足印刷级需求
4. 零依赖实现：提供 Python/PowerShell/curl 多平台参考代码
5. OC 生态集成：MEDIA: 协议自动触发附件上传，无额外开发

潜在缺点与局限

• 异步延迟：必须轮询等待，最坏情况 12 分钟，不适合实时交互
• URL 依赖：图生图需用户提前上传图片获取 URL，增加使用门槛
• 成本浮动：4K 画质未明确标价，存在超额计费风险
• 服务商单一：深度绑定 EvoLink，无备用 API 切换机制
• 24h 链接有效期：虽然本地文件持久保存，但原始 URL 短期失效可能影响复核

适合人群

• 内容创作者/设计师：需要批量生成高质量概念图、产品图
• 开发者：集成图像生成能力到自有工作流
• 成本敏感用户：追求 Stable Diffusion 级质量但不愿自建 GPU 集群

常规风险

| 风险类型 | 说明 |

|----------|------|

| API 密钥泄露 | `EVOLINK_API_KEY` 需妥善保管，建议配合密钥管理服务 |

| 内容合规 | 需遵守 EvoLink 平台的内容政策，NSFW/侵权内容可能导致封号 |

| 费用失控 | 4K 选项和大量调用可能产生意外账单，建议设置用量告警 |

| 服务可用性 | 轮询机制依赖 EvoLink 服务端稳定性，超时需优雅降级 |

核心用法

best-image-generation 通过 EvoLink Nano Banana Pro（gemini-3-pro-image-preview）模型提供企业级图像生成能力，支持三大核心模式：

• 文生图（Text-to-Image）：输入自然语言描述，自动生成高质量图像
• 图生图/智能编辑（Image-to-Image）：基于参考图片进行风格迁移、内容重绘或局部编辑
• 多图融合：支持最多 10 张参考图片（单张 ≤10MB）

调用方式：触发关键词为中文「高质量生图：xxx」「编辑图片：xxx」或英文「best image: xxx」「edit image: xxx」，冒号后内容自动识别为 prompt。技术实现采用「提交-轮询-下载」三阶段架构：POST 提交任务后，每 10 秒轮询状态，最长等待 12 分钟（72 次重试），完成后自动下载并输出 MEDIA:<absolute_path> 供 OC 框架自动挂载。

参数配置：尺寸支持 1:1、9:16、16:9 等 11 种比例，质量分 1K/2K/4K 三档（4K 额外计费）。输出格式自动识别 PNG/JPG/WebP，本地文件名带时间戳防覆盖。

显著优点

• 成本优势显著：单图 $0.12-0.20，远低于 Midjourney、DALL·E 3 等主流方案
• 零依赖轻量：纯标准库实现，Python/PowerShell/Bash 三平台原生支持，无需 conda/pip/npm
• 工程化完善：自动重试、超时保护、格式嗅探、OC 自动挂载，适合脚本化批量工作流
• 多模态灵活：10 图参考上限优于多数竞品（通常为 1-4 张），适合复杂构图需求
• 输出质量专业：gemini-3-pro-image-preview 模型在细节渲染和指令遵循度上表现优异

潜在缺点与局限性

• API 密钥依赖：必须持有 EvoLink 账户及 EVOLINK_API_KEY，国内用户可能面临网络访问问题
• 异步轮询开销：非即时响应，需等待 30 秒-12 分钟，不适合实时交互场景
• 4K 成本跳跃：高分辨率需额外付费，预算敏感场景需权衡质量与成本
• 服务商锁定：绑定 EvoLink 生态，暂无其他模型后端可选
• URL 有效期限制：生成链接 24 小时后失效，必须及时本地备份

适合人群

• 内容创作者、设计师、电商运营需批量生成商品图/海报/社交媒体素材
• 开发者构建自动化图像工作流（AIGC 管线、数据集生成）
• 对成本敏感但不愿牺牲质量的小团队与个人工作室
• 需图生图编辑能力（如风格迁移、局部重绘）的进阶用户

常规风险

• 密钥泄露风险：API key 存储于环境变量，共享环境或日志截屏可能导致盗刷
• 内容合规风险：生成内容受 EvoLink 服务条款约束，敏感 prompt 可能触发审核
• 网络稳定性：跨境 API 调用存在超时失败可能，建议配合指数退避重试策略
• 本地存储管理：自动下载文件持续累积，长期运行需配合清理脚本