进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第14章 使用 GPT Image 2.5 Flare 模型生成图片
GPT Image 2.5 Flare本指南介绍如何通过 Leonardo.AI REST API 使用 GPT Image 2.5 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.5-flare",
"parameters": {
"quality": "MEDIUM",
"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 请求端点、请求头与参数
端点
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可选。最多 16 张参考图片组成的数组。每张参考需包含 image.id、image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64),以及可选的 order。注意:GPT Image 2.5 Flare 不使用 strength 参数来控制图像参考。heightinteger可选。输入分辨率的高度,默认 1024。有效取值见下方表格。modelstring必填。模型标识符,设为 openai/gpt-image-2.5-flare。promptstring必填。描述想要生成图片的文本提示词,最长 9999 个字符。prompt_enhancestring可选。控制提示词增强,可选 AUTO、ON 或 OFF,默认 AUTO。publicboolean可选。布尔值,决定生成结果是否公开(true 为公开,false 为私有)。qualitystring可选。可选 LOW、MEDIUM、HIGH、XHIGH 或 MAX,默认 MEDIUM。quantityinteger可选。单次请求生成的图片数量(1-8),默认 4。style_idsarray可选。用于给输出应用预设艺术风格的风格 UUID 数组(限 1 个风格),默认 111dc692-d470-4eec-b791-3475abac4c46(Dynamic)。有效取值见下方表格。widthinteger可选。输入分辨率的宽度,默认 1024。有效取值见下方表格。
高度和宽度取值列表
模型高度宽度GPT Image 2.5 Flare640, 672, 768, 832, 848, 864, 896, 928, 1024, 1136, 1152, 1184, 1200, 1248, 1264, 1280, 1344, 1376, 1536, 1584, 1632, 1648, 1696, 1792, 1824, 1856, 1920, 2016, 2048, 2336, 2448, 2560, 2880, 3200, 3264, 3504, 3584768, 832, 848, 864, 896, 928, 1024, 1088, 1136, 1152, 1184, 1200, 1248, 1264, 1344, 1376, 1536, 1584, 1648, 1696, 1792, 1856, 2016, 2048, 2336, 2448, 2560, 2880, 3200, 3264, 3504, 3584, 3808
宽高比设置
宽高比宽度高度1:1102410242:384812643:2126484816:913767689:167681376
分辨率限制
仅支持离散取值
宽度和高度必须各自取自上文“高度与宽度列表”中的值。 不支持自动尺寸
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 更新于 2 个月前 此页面对你有帮助吗?
宽度和高度必须各自取自上文“高度与宽度列表”中的值。 不支持自动尺寸
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 更新于 2 个月前 此页面对你有帮助吗?