跳到内容

Nano Banana ​

更新时间

Nano Banana 是图片生成模型,支持文生图与参考图编辑。通过 TokenHub 路径同步调用,结果直接包含在响应正文中。

基本信息 ​

项目值
modelcustom-model-gn-v3.1
支持版本custom-model-gn-v3.1 / custom-model-gn-v3.1-lite / custom-model-gn-v3.0 / custom-model-gn-v2.5
默认值model=custom-model-gn-v3.1 / responseFormat=url
支持的操作文本 → 图片生成、图片编辑
输出尺寸1K / 2K / 4K
支持比例16:9 / 1:1 / 4:3 / 3:4 / 9:16
返回格式url / b64_json
安全护栏解除支持不支持

Endpoint ​

项目值
HTTP 方法POST
请求域名https://tokenhub.tencentcloudmaas.com
图片生成与编辑/v1/wand/gn-image/generation
认证Authorization: Bearer <API_KEY>
结果返回同步。生成结果包含在响应正文中

各地域接入地址

上述地址以广州为基准。新加坡、硅谷等各地域地址及备用地址请参考 API 使用指南。

准备工作 ​

  • 需已完成 TokenHub 服务开通与 API Key 发放。相关流程请参考 TokenHub Quick Start。

输入参数 ​

参数必填类型说明
model必填Stringcustom-model-gn-v3.1 / custom-model-gn-v3.1-lite / custom-model-gn-v3.0 / custom-model-gn-v2.5
contents必填Array由 role 与 parts 构成的内容数组
contents.role选填String消息角色。user
contents.parts必填Array由 text 或 inlineData 构成的条目数组
contents.parts.text必填String生成提示词
contents.parts.inlineData选填Object输入图片。仅在图片编辑时使用
contents.parts.inlineData.mimeType选填String输入图片类型。image/png / image/jpeg
contents.parts.inlineData.data选填String输入图片。可访问的 URL 或 Base64 字符串
generationConfig选填Object生成设置
generationConfig.responseModalities选填Array返回模态。["IMAGE"]
generationConfig.responseFormat选填Object图片输出设置
generationConfig.responseFormat.image.aspectRatio选填String16:9 / 1:1 / 4:3 / 3:4 / 9:16
generationConfig.responseFormat.image.imageSize选填String1K / 2K / 4K
responseFormat选填String返回图片格式。url / b64_json。默认值 url
logoAdd选填Integer是否添加水印。1 为添加,0 为不添加。默认值 0

输出参数 ​

参数类型说明
candidatesArray生成结果数组
candidates.content.parts.inlineData.dataString生成的图片。根据 responseFormat 为 URL 或 Base64
candidates.content.parts.inlineData.mimeTypeString生成图片类型
candidates.finishReasonString结束原因。正常完成时返回 STOP
candidates.indexInteger结果序号
modelVersionString实际生成所使用的模型版本
responseIdString响应 ID
tokenhub_usage.total_tokensInteger使用的 token 数
request_idString用于请求确认的 ID

请求示例 ​

bash
curl --location 'https://tokenhub.tencentcloudmaas.com/v1/wand/gn-image/generation' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
  "model": "custom-model-gn-v3.1",
  "contents": [
    {
      "parts": [
        {
          "text": "Dancing"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "responseFormat": {
      "image": {
        "aspectRatio": "9:16",
        "imageSize": "2K"
      }
    }
  }
}'

响应示例 ​

json
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "data": "https://xxxxxx.jpg",
              "mimeType": "image/jpeg"
            },
            "thoughtSignature": ""
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "modelVersion": "gemini-3.1-flash-image",
  "responseId": "uXd8arrMAeu-_uMP7v-g4Ag",
  "tokenhub_usage": {
    "total_tokens": 394260
  },
  "request_id": "5f0b3bf8-3ea8-46b5-b8af-529dabbc25af"
}

图片编辑 ​

在 contents.parts 中添加 inlineData 即为引用输入图片的编辑。请求体结构与响应结构与生成时相同。

输入参数 ​

参数必填类型说明
contents.parts.inlineData必填Object输入图片
contents.parts.inlineData.mimeType必填String输入图片类型。image/png / image/jpeg
contents.parts.inlineData.data必填String输入图片。可访问的 URL 或 Base64 字符串

生成与编辑使用同一个 Endpoint

文本生成与图片编辑使用同一个 Endpoint。编辑请求通过 inlineData 传递参考图片。

请求示例 ​

bash
curl --location 'https://tokenhub.tencentcloudmaas.com/v1/wand/gn-image/generation' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
  "model": "custom-model-gn-v3.1",
  "contents": [
    {
      "parts": [
        {
          "text": "Dancing"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "https://xxxxxxxxx.png"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "responseFormat": {
      "image": {
        "aspectRatio": "9:16",
        "imageSize": "2K"
      }
    }
  }
}'

响应示例 ​

json
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "data": "https://xxxxxx.jpg",
              "mimeType": "image/jpeg"
            },
            "thoughtSignature": ""
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "modelVersion": "gemini-3.1-flash-image",
  "responseId": "kT2pQmR7bvN-_yWL4w-h9De",
  "tokenhub_usage": {
    "total_tokens": 412870
  },
  "request_id": "a7c31e90-6d52-4f18-9b03-72e5cd14f8ba"
}

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages