进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第26章 通过 Leonardo.AI API 使用 Nano Banana 生成图像

# 第26章 Nano Banana 本指南介绍如何通过 Leonardo.AI REST API 使用 Nano Banana 生成图像。 ## 请求示例 ``` curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \ --header 'authorization: Bearer {api-key}' \ --header 'Content-Type: application/json' \ --data '{ "model": "gemini-2.5-flash-image", "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 请求地址、请求头和参数 请求地址 `https://cloud.leonardo.ai/api/rest/v2/generations` 请求头 ``` --header "accept: application/json" \ --header "authorization: Bearer " \ --header "content-type: application/json" ``` 请求体参数 | 参数 | 类型 | 说明 | |------|------|------| | guidances | object | 可选。定义图像引导输入的对象,用于影响生成结果。 | | guidances.image_reference | array | 可选。最多 6 张参考图像的数组。每张参考图像包含 image.id、image.type(GENERATED 或 UPLOADED)以及 strength(LOW、MID、HIGH)。 | | height | integer | 可选。输入分辨率的高度。 | | model | string | 必填。模型标识符,设置为 gemini-2.5-flash-image。 | | prompt | string | 必填。描述希望模型生成什么图像的文本提示词。 | | prompt_enhance | string | 可选。设为 "ON" 时启用提示词增强,设为 "OFF" 时禁用。 | | public | boolean | 可选。布尔标志,决定生成结果是公开(true)还是私有(false)。 | | quantity | integer | 可选。单次请求生成的图像数量。默认为 1,最大为 8。 | | seed | integer | 可选。设置固定随机种子,以保持多次生成结果的一致性。 | | style_ids | array | 可选。风格 UUID 数组,用于为输出应用预设艺术风格。 | | width | integer | 可选。输入分辨率的宽度。 | 高度和宽度取值列表 | 模型 | 高度 | 宽度 | |------|------|------| | Nano Banana | 0, 672, 768, 832, 864, 896, 1024, 1152, 1184, 1248, 1344 | 0, 672, 768, 832, 864, 896, 1024, 1152, 1184, 1248, 1344 | 如未指定,高度和宽度默认为 1024。 当高度和宽度均设为 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 | ## 图像引导 请求示例 ``` curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \ --header 'authorization: Bearer {api-key}' \ --header 'Content-Type: application/json' \ --data '{ "model": "gemini-2.5-flash-image", "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 }' ```
更新于 10 个月前 这个页面对你有帮助吗?

评论 (0)