进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第29章 Leonardo.AI API 使用 Nano Banana 2 Lite 生图指南
Nano Banana 2 Lite本指南介绍如何通过 Leonardo.AI REST API 使用 Nano Banana 2 Lite 生成图片。请求示例
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-lite",
"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"
Body 参数
参数类型说明guidancesobject可选。用于定义图像引导输入的对象,可影响生成结果。guidances.image_referencearray可选。最多 6 张参考图片组成的数组。每张参考图包含 image.id、image.type(GENERATED 或 UPLOADED)以及 strength(LOW、MID、HIGH)。heightinteger可选。输入分辨率的高度。modelstring必填。模型标识符,设为 nano-banana-2-lite。promptstring必填。描述想要生成的图片内容的文本提示词。prompt_enhancestring可选。控制提示词增强,可选值为 AUTO、ON 或 OFF,默认为 AUTO。publicboolean可选。布尔值,决定生成结果是否公开(true 为公开,false 为私有)。quantityinteger可选。单次请求生成的图片数量,默认为 1,最大为 8。seedinteger可选。指定固定 seed,以便在多组生成之间保持一致性。style_idsarray可选。风格 UUID 数组,用于为输出应用预设艺术风格。最多 1 个风格,默认为 Dynamic(111dc692-d470-4eec-b791-3475abac4c46)。widthinteger可选。输入分辨率的宽度。
高度和宽度可选值
模型高度宽度Nano Banana 2 Lite0, 672, 768, 848, 896, 928, 1024, 1152, 1200, 1264, 13760, 768, 848, 896, 928, 1024, 1152, 1200, 1264, 1376, 1584
未指定时,默认高度和宽度均为 1024。
当宽度和高度都设为 0 时,输出会尽量与输入的参考图片保持一致。
风格 ID 列表
预设风格UUID3D Renderdebdf72a-91a4-467b-bf61-cc02bdeb69c6Acrylic3cbb655a-7ca4-463f-b697-8a03ad67327cCreative6fedbf1f-4a17-45ec-84fb-92fe524a29efDynamic111dc692-d470-4eec-b791-3475abac4c46Fashion594c4a08-a522-4e0e-b7ff-e4dac4b6b622Game Concept09d2b5b5-d7c5-4c02-905d-9f84051640f4Graphic Design 2D703d6fe5-7f1c-4a9e-8da0-5331f214d5cfGraphic Design 3D7d7c2bc5-4b12-4ac3-81a9-630057e9e89fIllustration645e4195-f63d-4715-a3f2-3fb1e6eb8c70None556c1ee5-ec38-42e8-955a-1e82dad0ffa1Portrait Cinematic4edb03c9-8a26-4041-9d01-f85b5d4abd71Portrait Fashion0d34f8e1-46d4-428f-8ddd-4b11811fa7c9Pro B&W photography22a9a7d2-2166-4d86-80ff-22e2643adbcfPro Color Photography7c3f932b-a572-47cb-9b9b-f20211e63b5bPro Film Photography581ba6d6-5aac-4492-bebe-54c424a0d46eRay Tracedb504f83c-3326-4947-82e1-7fe9e839ec0fStock Photo5bdc3f2a-1be6-4d1c-8e77-992a30824a2cWatercolor1db308ce-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": "nano-banana-2-lite",
"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
}'
5 个月前更新 此页面对你有帮助吗?
5 个月前更新 此页面对你有帮助吗?