跳转到主要内容
POST
/
v1beta
/
models
/
{model}
:generateContent
curl --request POST \
  --url https://api.getinfinityblue.com/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "画一只猫，坐在月光下的屋顶上"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "4K"
    }
  }
}
'
{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {}
        ]
      },
      "finishReason": "<string>",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123
  }
}

​
可使用的模型

模型 ID说明
nanobanana标准版，均衡速度与质量
nanobanana_pro高质量版，适合产品图、精细风格统一
nanobanana_2第二代，特价分组仅支持 OpenAI 聊天格式（见独立接口）

​
多图参考

在 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 用量统计。