Nano Banana
Nano Banana 是图片生成模型,支持文生图与参考图编辑。通过 TokenHub 路径同步调用,结果直接包含在响应正文中。
基本信息
| 项目 | 值 |
|---|---|
| model | custom-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 | 必填 | String | custom-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 | 选填 | String | 16:9 / 1:1 / 4:3 / 3:4 / 9:16 |
generationConfig.responseFormat.image.imageSize | 选填 | String | 1K / 2K / 4K |
responseFormat | 选填 | String | 返回图片格式。url / b64_json。默认值 url |
logoAdd | 选填 | Integer | 是否添加水印。1 为添加,0 为不添加。默认值 0 |
输出参数
| 参数 | 类型 | 说明 |
|---|---|---|
candidates | Array | 生成结果数组 |
candidates.content.parts.inlineData.data | String | 生成的图片。根据 responseFormat 为 URL 或 Base64 |
candidates.content.parts.inlineData.mimeType | String | 生成图片类型 |
candidates.finishReason | String | 结束原因。正常完成时返回 STOP |
candidates.index | Integer | 结果序号 |
modelVersion | String | 实际生成所使用的模型版本 |
responseId | String | 响应 ID |
tokenhub_usage.total_tokens | Integer | 使用的 token 数 |
request_id | String | 用于请求确认的 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"
}