Skip to main content
POST
Gemini 文生图 API
使用 Nano Banana Pro、2 或 2.1,根据文字描述生成图片。 POST /v1beta/models/{model}:generateContent 文生图和图片编辑使用同一个接口;图片编辑的请求中需要增加参考图。

在线调试

在 x-goog-api-key 中填写 BetterToken API Key,选择 model,并修改 contents 中的提示词。先使用 1K、1:1,然后点击 Send。
点击 Send 会发起真实生成请求,可能产生费用。接口同步等待生成完成;超时或断连后,请先核对消费记录和请求结果,再决定是否重新发送。
三款均提供 1K、2K、4K。Nano Banana 2 和 2.1 支持 14 种比例,Pro 支持 10 种。 X-BetterToken-Max-Images 是允许返回并计费的图片数量上限,不保证生成对应张数。 比例列表
BetterToken API 不支持搜索生图,包括 Google 网页搜索和图片搜索增强。不要添加搜索工具。
文生图只需提交文字描述,无需参考图。接口使用非流式 generateContent;不支持 Files、Batch、Interactions 或流式调用。

读取响应

图片位于 candidates[].content.parts[].inlineData。遍历所有 part,跳过 thought: true,解码 data,并根据 mimeType 选择文件后缀。不要假定图片总在第一个 part,也不要一律保存成 PNG。

相关文档

授权

x-goog-api-key
string
header
必填

BetterToken API Key。

请求头

X-BetterToken-Max-Images
integer
默认值:1

允许返回并计费的图片数量上限,不保证生成对应张数。默认值为 1。

必填范围: 1 <= x <= 4

路径参数

model
enum<string>
默认值:nano-banana-2.1
必填

BetterToken 模型 ID,选择三款 Nano Banana 模型之一。

可用选项:
nano-banana-pro,
nano-banana-2,
nano-banana-2.1

请求体

application/json
contents
object[]
必填

对话内容。连续编辑时保留完整模型 content 和 thoughtSignature。

Minimum array length: 1
generationConfig
object

图片生成配置。

响应

生成结果。检查最终图片 part 和 finishReason。

candidates
object[]
promptFeedback
object
usageMetadata
object