Nano Banana 模型接入

概览

OneLinkAI 提供 Gemini 官方兼容接口，用于在 OneLinkAI 网关下调用 Google Gemini 的图片生成能力。整体目标是尽可能兼容 Gemini 官方协议，方便已经接入 Gemini 官方接口的业务快速迁移或并行接入。

本文重点说明 Nano Banana：Gemini 原生图片生成能力，适用于文生图与图像编辑。

接入规则

鉴权方式

调用 OneLinkAI 的 Gemini 兼容接口时，统一使用 Bearer Token 鉴权：

路径规则

在 OneLinkAI 中，Gemini 兼容接口沿用 Gemini 官方接口路径结构，图像生成主要使用以下路径：

官方路径：POST https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent

OneLinkAI 路径：POST /v1beta/models/{model}:generateContent

也就是说，如果你已经接入过 Gemini 官方接口，通常只需要：

将请求地址替换为 OneLinkAI 对应网关地址。

将官方 x-goog-api-key 鉴权替换为 OneLinkAI 的 Authorization: Bearer <ApiKey>。

按照当前支持范围继续使用原有请求体结构与响应体结构进行联调。

通用调用方式

Nano Banana 使用 generateContent 同步返回结果。

生成的图片数据通常位于响应体的 candidates[].content.parts[].inlineData 字段中。

请求体字段与响应体结构按 Gemini 官方文档整理，OneLinkAI 保留统一鉴权与网关路径。

能力清单

以下内容用于快速说明 OneLinkAI 对 Gemini 官方 Nano Banana 能力的当前支持范围：

能力名称	是否支持	参考文档
文生图	✔️	https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn
图像编辑	✔️	https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

文生图与图像编辑

兼容 Google Gemini 官方 models.generateContent 协议的图片生成接口

常用模型：gemini-2.5-flash-image、gemini-3.1-flash-image-preview、gemini-3-pro-image-preview

核心请求字段：路径参数 model，请求体中的 contents、generationConfig.responseModalities、generationConfig.imageConfig.aspectRatio

图像编辑场景可在 contents[].parts[] 中同时传入 text 与 inlineData

核心响应字段：candidates[].content.parts[].text、candidates[].content.parts[].inlineData.mimeType、candidates[].content.parts[].inlineData.data、usageMetadata

官方说明中提到，生成图片默认包含 SynthID 水印

使用建议

如果你已经接入过 Gemini 官方接口，推荐优先复用原有请求体结构与业务侧调用逻辑。

图像编辑场景下，建议将文本指令与输入图片一并放在 contents[].parts[] 中，便于保持与官方调用方式一致。

具体模型可用性、字段约束、分辨率支持、错误码与边界行为，请以对应官方接口文档为准。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

接口详情#

文生图与图像编辑#

使用建议#

概览