NanoBanana 原生格式

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
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

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
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "param": "<string>",
    "code": "<string>"
  }
}

可使用的模型

模型 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 中可同时放入文本提示和多张参考图片。

Show child attributes

generationConfig

object

必填

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

Show child attributes

响应

成功生成图像

NanoBanana 原生格式响应体。

candidates

object[]

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

Show child attributes

usageMetadata

object

Token 用量统计。

Show child attributes

开始使用

模型（Models）

聊天（Chat）

图像（Images）

视频（Videos）

指南

可使用的模型

多图参考

分辨率配置

思考内容

授权

路径参数

请求体

响应

​可使用的模型

​多图参考

​分辨率配置

​思考内容

授权

路径参数

请求体

响应

可使用的模型

多图参考

分辨率配置

思考内容