生图介绍
当前仅提供 Gemini 兼容的 Nano Banana(香蕉)系列生图服务,支持文生图与图生图。完整参数见 Gemini 接入指南。
模型与计费
| 模型命名 | 计费方式 | 示例 |
|---|---|---|
带 -c 后缀 | 按次计费 | gemini-3-pro-image-c |
不带 -c 后缀 | 按 token 计费 | gemini-3-pro-image |
旧版固定分辨率后缀模型已下线。后缀用于区分计费方式,不再表示固定分辨率。请通过 模型查询 确认当前 Key 可用的完整名称,具体单价与扣费以控制台及账户账单为准。
香蕉系列
| 模型族 | 后端 | 特点 |
|---|---|---|
gemini-3-pro-image | Nano Banana Pro | Pro 系列,效果与耗时依请求而异,不作绝对排名 |
gemini-3.1-flash-image | Nano Banana 2 | Flash 系列,效果与耗时请结合业务验证 |
gemini-nano-banana-2.1 | Nano Banana 2.1 | 新增香蕉模型,具体能力以模型说明为准 |
上表为模型族介绍,不代表每个 Key 都具有全部模型权限。
分辨率
带 -c 后缀的模型通过请求中的 generationConfig.imageConfig.imageSize 选择 1K / 2K / 4K,不传时默认 1K,不再使用模型名选择分辨率。
不带 -c 模型的分辨率参数支持情况请以具体模型说明为准,不要沿用已下线模型的固定分辨率规则。
能力
以下说明接入方式,不是所有模型的统一能力承诺。Nano Banana 2.1 的宽高比、参考图上限及分辨率支持尚待确认,不直接套用其他模型的规则。
| 能力 | 支持 |
|---|---|
| 文生图 | ✅ |
| 图生图 / 改图 | 通过 inlineData 传入参考图,多图支持及数量上限按具体模型确认 |
| 宽高比 | 按具体模型确认,不统一承诺 14 种;Pro 的超长比例限制见宽高比说明 |
| 流式返回 | IMAGE 生图建议使用非流式;旧行为及适用范围见流式说明 |
| 单次出图张数 | 示例按 1 张处理,不依赖 candidateCount 请求多图 |
| 返回形态 | IMAGE 示例使用 inlineData 内嵌 base64,以实际响应的 mimeType 为准 |
| 用量统计 | ✅ 非流式响应带 usageMetadata;用量统计不等于计费方式 |
接入方式
POST /v1beta/models/{model}:generateContent
生图必须明确指定 IMAGE
generationConfig.responseModalities 必须明确包含 "IMAGE",建议设置为 ["IMAGE"]。后端为兼容首字快速响应已兼容 TEXT 模式,省略该参数或仅指定 TEXT 时,Pro 模型可能生成文字。
默认接入端点为 https://api.llmnex.com,香港加速端点为 https://hk.llmnex.com。切换端点时只替换基础地址,接口路径保持不变,详见 API 地址与鉴权。
耗时参考
当前生图速度较此前大幅提升,常见耗时参考如下,不代表时延保证。
| 分辨率 | 常见耗时(首字节) |
|---|---|
| 1K | 约 15–25 秒 |
| 2K | 约 15–35 秒 |
| 4K | 约 20–45 秒 |
以上是服务端出图时间,图片传输另计,高峰期会整体拉长。客户端超时建议设到 300 秒,4K 弱网建议 600 秒。