Skip to main content
POST

可使用的模型

多图参考

在 contents[].parts 中连续追加多个 inline_data 对象, 每个对象对应一张参考图的 Base64 数据,即可实现多图参考输入。

分辨率配置

generationConfig.imageConfig 中:
  • aspectRatio:1:1、3:4、4:3、9:16、16:9
  • imageSize:1K、2K、4K

思考内容

设置 generationConfig.thinkingConfig.includeThoughts: true 可在响应中返回模型的推理过程。

授权

Authorization
string
header
必填

使用 Bearer Token 认证,格式:Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

路径参数

model
string
必填

NanoBanana 模型 ID,例如 nanobanana_pro。 可选值:nanobanana、nanobanana_pro。

请求体

application/json

NanoBanana 原生格式图像生成/编辑请求体。

contents
object[]
必填

对话内容列表。通常传入一条 user 消息; 在该消息的 parts 中可同时放入文本提示和多张参考图片。

generationConfig
object
必填

生成参数配置,用于控制返回模态、图片规格等。

响应

成功生成图像

NanoBanana 原生格式响应体。

candidates
object[]

模型生成的候选结果列表。

usageMetadata
object

Token 用量统计。