进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第16章 通过 Leonardo.AI API 使用 GPT Image 2.6 Flare 生成图像
GPT Image 2.6 Flare本指南介绍如何通过 Leonardo.AI REST API 使用 GPT Image 2.6 Flare 模型生成图像。请求示例
curl --location 'https://cloud.leonardo.ai/api/rest/v2/generations' \
--header 'authorization: Bearer {api-key}' \
--header 'Content-Type: application/json' \
--data '{
"public": false,
"model": "openai/gpt-image-2.6-flare",
"parameters": {
"quality": "HIGH",
"complexity": "HIGH",
"prompt": "Koala with purple hat",
"quantity": 2,
"width": 1376,
"height": 768,
"prompt_enhance": "OFF",
"style_ids": [
"111dc692-d470-4eec-b791-3475abac4c46"
],
"guidances": {
"image_reference": [
{
"image": {
"id": "00000000-0000-0000-0000-000000000001",
"type": "UPLOADED"
}
}
]
}
}
}'
配置说明
API 请求端点、Headers 和参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
Headers
--header "accept: application/json" \
--header "authorization: Bearer " \
--header "content-type: application/json"
Body 参数
参数类型说明annotationboolean可选。当图像参考上画有标注(指示需要修改的地方)时设为 true。complexitystring可选。控制模型在渲染前对图像的规划程度,与 quality 相互独立。数值越高,对密集文字和复杂布局的效果越好,但耗时可能更长。可选值:LOW、MEDIUM、HIGH,默认为 HIGH。guidancesobject可选。定义影响生成结果的图像引导输入。guidances.image_referencearray可选。参考图像数组,最多 16 张。每张参考图包含 image.id、image.type(可选 UPLOADED、GENERATED、VARIATION、URL 或 BASE64),以及可选的 order。type 为 URL 时使用 image.url,type 为 BASE64 时使用 image.data(base64 编码的图像字节)。注意:GPT Image 2.6 Flare 不使用 image reference 的 strength 参数。heightinteger可选。高度分辨率,默认为 1024。必须为 16 的倍数,取值范围 16–3840,长边最多为短边的三倍。常用取值见下方章节。modelstring必填。模型标识符,设为 openai/gpt-image-2.6-flare。promptstring必填。描述所需图像的文本提示词,最多 9999 个字符。prompt_enhancestring可选。控制提示词增强。可选值:AUTO、ON、OFF,默认为 AUTO。publicboolean可选。布尔值,决定生成结果是公开(true)还是私有(false)。qualitystring可选。可选值:LOW、MEDIUM、HIGH、XHIGH、MAX,默认为 HIGH。quantityinteger可选。单次请求生成的图像数量(1–8),默认为 4。style_idsarray可选。用于给输出应用预设艺术风格的风格 UUID 数组(最多 1 个风格)。默认为 111dc692-d470-4eec-b791-3475abac4c46(Dynamic),详见下方表格。transparencyboolean可选。设为 true 可生成带透明背景的图像。widthinteger可选。宽度分辨率,默认为 1024。必须为 16 的倍数,取值范围 16–3840,长边最多为短边的三倍。常用取值见下方章节。
宽高比设置
宽高比宽度高度1:1102410242:384812643:2126484816:913767689:167681376
分辨率限制
仅支持 16 的倍数
宽度和高度必须均为 16 的倍数,取值范围从 16 到 3840。 最大宽高比为 3:1
长边最多只能是短边的 3 倍。 不支持自动缩放
0 不是有效的宽度或高度值,也不支持 size: "auto",请勿向 API 传入该值。 风格 ID 列表 Preset Style UUID 3D Render debdf72a-91a4-467b-bf61-cc02bdeb69c6 Acrylic 3cbb655a-7ca4-463f-b697-8a03ad67327c Cinematic a5632c7c-ddbb-4e2f-ba34-8456ab3ac436 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 ab5a4220-7c42-41e5-a578-eddb9fed3d75 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 Vibrant dee282d3-891f-4f73-ba02-7f8131e5541b Watercolor 1db308ce-c7ad-4d10-96fd-592fa6b75cc4 更新于 9 天前 本页对您有帮助吗?
宽度和高度必须均为 16 的倍数,取值范围从 16 到 3840。 最大宽高比为 3:1
长边最多只能是短边的 3 倍。 不支持自动缩放
0 不是有效的宽度或高度值,也不支持 size: "auto",请勿向 API 传入该值。 风格 ID 列表 Preset Style UUID 3D Render debdf72a-91a4-467b-bf61-cc02bdeb69c6 Acrylic 3cbb655a-7ca4-463f-b697-8a03ad67327c Cinematic a5632c7c-ddbb-4e2f-ba34-8456ab3ac436 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 ab5a4220-7c42-41e5-a578-eddb9fed3d75 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 Vibrant dee282d3-891f-4f73-ba02-7f8131e5541b Watercolor 1db308ce-c7ad-4d10-96fd-592fa6b75cc4 更新于 9 天前 本页对您有帮助吗?
上一篇
第15章 通过 Leonardo.AI API 使用 GPT Image 2.5 Sunburst
下一篇
第17章 通过Leonardo.AI API调用GPT Image 2.6 Sunburst生成图像指南