图片 / 香蕉 Nano Banana

Nano Banana · 默认 URL

香蕉 2.0 / 2.1 / 2 Pro 的主渠道，推荐走 Gemini 原生 generateContent 协议，也兼容 OpenAI Images、Chat Completions 等写法。不写 response_format 时默认返回本站图片链接（1 小时有效）；与 #125 模型、价格、写法完全相同，只是默认返回格式不同。香蕉 2.1 还能把 PDF、视频作为参考生成图片。

分组 #139「【原生生图】Nano Banana 主渠道 · 默认 URL」 · Key 需属于该分组

文生图图生图PDF / 视频参考1K / 2K / 4KURL 返回（默认）Base64 返回多轮改图Gemini 原生OpenAI Images 兼容

价格—

24 小时成功率—

可用模型

模型	说明	价格
`gemini-3-pro-image`	香蕉 2 Pro；文档示例使用同系列 -preview 名称；按张 $0.055	—
`gemini-3-pro-image-preview`	香蕉 2 Pro，文字生图与参考图编辑；按张 $0.055	—
`gemini-3.1-flash-image`	香蕉 2.0；文档示例使用同系列 -preview 名称；按张 $0.04	—
`gemini-3.1-flash-image-preview`	香蕉 2.0，文字生图与单图、多图参考；按张 $0.04	—
`gemini-nano-banana-2.1`	香蕉 2.1，可用图片、PDF、视频作为参考；按张 $0.05	—

接口

`POST /v1beta/models/{model}:generateContent`	Gemini 原生（推荐）：文生图、图生图、PDF / 视频参考；模型名写在 URL 中，鉴权 x-goog-api-key 或 Bearer
`POST /v1/images/generations`	OpenAI Images 兼容文生图，Bearer 鉴权，JSON
`POST /v1/images/edits`	OpenAI Images 兼容图生图：JSON images[].image_url（Data URL 或公开 HTTPS 直链），或 multipart image / image[]
`POST /v1/chat/completions`	Chat Completions 兼容，图片在 message.content 的 Markdown 图片链接中
`POST /v1/messages`	Anthropic Messages 写法，图片在 content[].text 的 Markdown 图片中（2026-10-22 实测可用）
`POST /v1/responses`	Responses 写法，图片在 output[].content[].text 的 Markdown 图片中（2026-10-22 实测可用）
`POST /v1beta/models/{model}:streamGenerateContent?alt=sse`	原生流式；图片流式目前暂停，请求立即返回 HTTP 400，不生成、不计费
`GET /v1beta/models`	Gemini 客户端获取当前 Key 的模型，请求头 x-goog-api-key
`GET /v1/models`	用同一把 Key 查询当前分组可用的完整模型名

能力与限制

计费方式	按张：香蕉 2.0 $0.04、香蕉 2.1 $0.05、香蕉 2 Pro $0.055（分组倍率 1）
默认返回	图片链接：原生为 fileData.fileUri，并附一个 ![image](链接) 文本项；Images 为 data[].url；加 "response_format": "b64_json" 改为 Base64
imageSize	1K / 2K / 4K，K 大写；1K 是档位，不等于固定 1024×1024，实际像素以返回图片为准
OpenAI Images 兼容入口	每次 n=1、stream=false；参考图 PNG / JPEG / WebP，最多 14 张、合计 20 MiB；mask 局部蒙版暂未接通
原生附件类型	PNG、JPEG、WebP、PDF、MP4（优先 H.264）已验证；CSV / JSON 附件已实测；DOCX 尚未验证成功，文档优先用 PDF
请求体大小	入口上限 256 MiB，不代表模型或上游的可用上限；Base64 会使体积增加约三分之一
图片链接	本站域名，1 小时内有效，过期返回 404；无需 Key 即可下载，支持 HEAD 和 Range
超时建议	客户端不少于 300 秒（4K 和多参考图耗时更长）；下载单张大图建议不少于 120 秒
流式	图片流式目前暂停：streamGenerateContent 和 stream=true 立即返回 HTTP 400，不生成、不计费

请求参数

字段	类型		说明
`contents[].role`	string	必填	示例填写 user；多轮时按 user → model → user 顺序组织
`contents[].parts[].text`	string	必填	提示词；多图时说明每张图的用途
`contents[].parts[].inlineData.mimeType`	string	可选	参考文件 MIME：image/png、image/jpeg、image/webp、application/pdf、video/mp4 等，字段名拼写为 mimeType
`contents[].parts[].inlineData.data`	string	可选	完整文件的纯 Base64，不带 data:...;base64, 前缀
`contents[].parts[].fileData`	object	可选	公开 PDF / MP4 直链：填写 mimeType 和 fileUri，链接需直接返回文件
`generationConfig.responseModalities`	array	可选	["IMAGE"] 只返回图片；需要文字时用 ["TEXT", "IMAGE"]，仍需检查实际返回内容
`generationConfig.imageConfig.imageSize`	string	可选	1K / 2K / 4K，字母 K 必须大写
`generationConfig.imageConfig.aspectRatio`	string	可选	宽高比，例如 1:1、3:2；实际像素与比例、模型有关
`generationConfig.thinkingConfig`	object	可选	仅香蕉 2.1：thinkingLevel 官方支持 minimal / medium（默认）/ high，includeThoughts 控制是否返回思考内容；是否生效取决于渠道，常规生图可省略
`response_format`	string	可选	本站扩展，放在请求体顶层：b64_json 返回 Base64（inlineData），url 返回本站图片链接（fileData）

注意事项

原生协议的模型名写在请求 URL 中，不放进 JSON 的 model 字段，也不要混入 OpenAI Images 的其他字段。
Gemini 客户端 Base URL 通常填 https://yyds.seqnode.com；客户端要求完整前缀时填 https://yyds.seqnode.com/v1beta，避免重复拼接。
遍历 candidates[].content.parts[]，跳过 thought: true 项；最终图片是 inlineData（Base64）或 fileData（链接），文字与图片可能同时返回，不要默认第一项就是图片。
保存时按返回的 mimeType 选扩展名，例如 image/jpeg 存为 .jpg、image/png 存为 .png。
#125 与 #139 模型、价格和写法完全相同，同一段代码换 Key 即可切换；写了 response_format 后两组结果相同。
Chat Completions 和 Responses 在两组都默认返回 Markdown 图片链接，要 Base64 必须写 "response_format": "b64_json"。
香蕉 2.1 可混合图片、PDF 和视频作为参考，每个文件占一个 part；视频是参考输入，输出仍是图片。
签名多轮需按原顺序回传上一轮全部 model parts（含完整图片和 thoughtSignature），不要截断或改写签名；签名可能长达百万字符以上。
本站 Files 上传流程尚未接通，附件用 inlineData 或公开直链 fileData。
超时或 5xx 时先核对使用记录，再决定是否重新提交，避免重复生成。
图片链接持有即可访问，请勿公开分享；网络无法访问图片域名时改用 "response_format": "b64_json"。
签名多轮需要回传完整 inlineData 图片，本组请在每轮请求体顶层加 "response_format": "b64_json"。
只读 Base64 的客户端用本组会拿不到图片，请改用 #125 或显式写 b64_json。

常见错误

返回	原因与处理
`401 / 403`	Key 错误、已禁用或未绑定该分组；检查 Authorization: Bearer 请求头、绑定分组和访问权限。
`451 prompt or image unsafe · The provided prompt is considered unsafe…`	提示词、参考图或生成结果触发内容安全审核；修改描述或更换参考图后重试。
`502 Upstream request failed after retries`	站内已自动重试仍失败；稍后再试，4K 和多参考图耗时更长，客户端超时建议不少于 300 秒。
`404 Model "…" is not supported by any configured account in this group`	该分组没有这个模型名；按模型广场列出的名称调用。
`400 … INVALID_ARGUMENT …`	请求体不符合 generateContent 格式；检查 contents、inlineData（纯 Base64）、imageSize 大小写与 generationConfig。
`400（流式请求）`	图片流式目前暂停；改用非流式 generateContent 或去掉 stream=true。
`413`	附件过大；减小附件，Base64 会增加约三分之一体积。
`429`	检查额度、并发及上游状态，按提示等待，避免循环重发。
`200 但没有图片`	检查 finishReason、promptFeedback 和返回文字，不能只看状态码。