进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第28章 通过 Leonardo.AI API 使用 Nano Banana 2 生成图像
# 第28章 Nano Banana 2
本指南介绍如何通过 Leonardo.AI REST API 使用 Nano Banana 2 生成图像。
## 请求示例
```bash
curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \
--header 'authorization: Bearer {api-key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "nano-banana-2",
"parameters": {
"width": 1024,
"height": 1024,
"prompt": "a portrait-style photograph featuring a koala",
"quantity": 1,
"style_ids": [
"111dc692-d470-4eec-b791-3475abac4c46"
],
"prompt_enhance": "OFF"
},
"public": false
}'
```
## 配方
## 高度与宽度列表
## 尺寸
API 接受以下宽高比组合的 width 和 height 参数:
## 图像引导
### 请求示例
```bash
curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \
--header 'authorization: Bearer {api-key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "nano-banana-2",
"parameters": {
"width": 1024,
"height": 1024,
"prompt": "A koala is wearing a colourful Hawaiian shirt",
"quantity": 1,
"guidances": {
"image_reference": [
{
"image": {
"id": "fc6f78c6-e7ac-491b-ad26-01f6843db870",
"type": "GENERATED"
},
"strength": "MID"
},
{
"image": {
"id": "a8e374dd-52f8-4236-ad9e-99b1f601fa3a",
"type": "UPLOADED"
},
"strength": "MID"
}
]
},
"style_ids": [
"111dc692-d470-4eec-b791-3475abac4c46"
],
"prompt_enhance": "OFF"
},
"public": false
}'
```
更新于 9 个月前 这个页面对你有帮助吗?
API 请求端点、请求头与参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
请求头
--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"
Body 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| guidances | object | 可选。定义图像引导输入的对象,用于影响生成结果。 |
| guidances.image_reference | array | 可选。最多包含 6 张参考图的数组。每张参考图包含 image.id、image.type(GENERATED 或 UPLOADED)以及 strength(LOW、MID、HIGH)。 |
| height | integer | 可选。输入分辨率的高度。有效的高度与宽度组合请参考下表。 |
| model | string | 必填。模型标识符,可选模型见下表。此处设置为 nano-banana-2。 |
| prompt | string | 必填。描述你希望模型生成什么图像的文本提示词。 |
| prompt_enhance | string | 可选。设为 "ON" 时启用提示词增强;设为 "OFF" 时禁用。 |
| public | boolean | 可选。布尔值,决定生成结果是否公开(true)或私有(false)。 |
| quantity | integer | 可选。单次请求生成的图像数量。默认为 1,最大为 8。 |
| seed | integer | 可选。使用固定 seed 以保持多组生成结果的一致性。 |
| style_ids | array | 可选。风格 UUID 数组,用于为输出应用预设艺术风格。 |
| width | integer | 可选。输入分辨率的宽度。有效的宽度与高度组合请参考下表。 |
| 模型 | 高度 | 宽度 |
|---|---|---|
| Nano Banana 2 | 672, 768, 848, 896, 928, 1024, 1152, 1200, 1264, 1344, 1376, 1536, 1696, 1792, 1856, 2048, 2304, 2400, 2528, 2688, 2752, 3072, 3392, 3584, 3712, 4096, 4608, 4800, 5056, 5504 | 768, 848, 896, 928, 1024, 1152, 1200, 1264, 1376, 1536, 1584, 1696, 1792, 1856, 2048, 2304, 2400, 2528, 2752, 3072, 3168, 3392, 3584, 3712, 4096, 4608, 4800, 5056, 5504, 6336 |
| 宽高比 | 1K(小) | 2K(中) | 4K(大) |
|---|---|---|---|
| 1:1 | 1024 × 1024 | 2048 × 2048 | 4096 × 4096 |
| 2:3 | 848 × 1264 | 1696 × 2528 | 3392 × 5056 |
| 3:2 | 1264 × 848 | 2528 × 1696 | 5056 × 3392 |
| 3:4 | 896 × 1200 | 1792 × 2400 | 3584 × 4800 |
| 4:3 | 1200 × 896 | 2400 × 1792 | 4800 × 3584 |
| 4:5 | 928 × 1152 | 1856 × 2304 | 3712 × 4608 |
| 5:4 | 1152 × 928 | 2304 × 1856 | 4608 × 3712 |
| 9:16 | 768 × 1376 | 1536 × 2752 | 3072 × 5504 |
| 16:9 | 1376 × 768 | 2752 × 1536 | 5504 × 3072 |
| 21:9 | 1584 × 672 | 3168 × 1344 | 6336 × 2688 |
注意:width 和 height 参数会分别进行校验,但不会校验二者的组合是否为支持的宽高比配对。即使两个值各自有效,只要不符合上表所列的支持宽高组合,请求仍会被接受。此时传给模型的宽高比会静默回退为 1:1,且不会返回任何校验错误。为确保使用预期的宽高比,请始终提供与支持配对完全一致的 width 和 height 组合。 当 width 和 height 均设为 0 时,系统会尝试匹配输入参考图的宽高比。 ## 风格 ID 列表
| 预设风格 | UUID |
|---|---|
| 3D Render | debdf72a-91a4-467b-bf61-cc02bdeb69c6 |
| Acrylic | 3cbb655a-7ca4-463f-b697-8a03ad67327c |
| Creative | 6fedbf1f-4a17-45ec-84fb-92fe524a29ef |
| Dynamic | 111dc692-d470-4eec-b791-3475abac4c46 |
| Fashion | 594c4a08-a522-4e0e-b7ff-e4dac4b6b622 |
| Game Concept | 09d2b5b5-d7c5-4c02-905d-9f84051640f4 |
| Graphic Design 2D | 703d6fe5-7f1c-4a9e-8da0-5331f214d5cf |
| Graphic Design 3D | 7d7c2bc5-4b12-4ac3-81a9-630057e9e89f |
| Illustration | 645e4195-f63d-4715-a3f2-3fb1e6eb8c70 |
| None | 556c1ee5-ec38-42e8-955a-1e82dad0ffa1 |
| Portrait | 8e2bc543-6ee2-45f9-bcd9-594b6ce84dcd |
| Portrait Cinematic | 4edb03c9-8a26-4041-9d01-f85b5d4abd71 |
| Portrait Fashion | 0d34f8e1-46d4-428f-8ddd-4b11811fa7c9 |
| Pro B&W photography | 22a9a7d2-2166-4d86-80ff-22e2643adbcf |
| Pro Color Photography | 7c3f932b-a572-47cb-9b9b-f20211e63b5b |
| Pro Film Photography | 581ba6d6-5aac-4492-bebe-54c424a0d46e |
| Ray Traced | b504f83c-3326-4947-82e1-7fe9e839ec0f |
| Stock Photo | 5bdc3f2a-1be6-4d1c-8e77-992a30824a2c |
| Watercolor | 1db308ce-c7ad-4d10-96fd-592fa6b75cc4 |
更新于 9 个月前 这个页面对你有帮助吗?
上一篇
第27章 通过 Leonardo.AI API 使用 Nano Banana Pro 生成图像
下一篇
第29章 Leonardo.AI API 使用 Nano Banana 2 Lite 生图指南