进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第17章 通过Leonardo.AI API调用GPT Image 2.6 Sunburst生成图像指南
第17章 GPT Image 2.6 Sunburst
本指南演示如何通过 Leonardo.AI REST API 使用 GPT Image 2.6 Sunburst 模型生成图像。
示例请求
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-sunburst",
"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 请求端点、请求头与参数
端点
https://cloud.leonardo.ai/api/rest/v2/generations
请求头
--header "accept: application/json" \
--header "authorization: Bearer <YOUR_API_KEY>" \
--header "content-type: application/json"
请求体参数
| 参数 | 类型 | 定义 |
|---|---|---|
| annotation | boolean | 可选。当参考图像上带有标记以指示需要修改的内容时,设为 true。 |
| complexity | string | 可选。控制模型在渲染前对图像的规划程度,独立于 quality。较高值有助于处理密集文本和复杂布局,但耗时可能更长。接受 LOW、MEDIUM 或 HIGH。默认为 HIGH。 |
| guidances | object | 可选。定义影响生成结果的图像引导输入对象。 |
| guidances.image_reference | array | 可选。最多包含 16 张参考图像的数组。每张参考图包含 image.id、image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)以及可选的 order。当 type 为 URL 时使用 image.url,当 type 为 BASE64 时使用 image.data(base64 编码的图像字节)。注意:GPT Image 2.6 Sunburst 不使用 strength 参数来处理图像参考。 |
| height | integer | 可选。高度输入分辨率。默认为 1024。必须是 16 的倍数,范围在 16 到 3840 之间。长边最多可以是短边的三倍。常用值见下文相关章节。 |
| model | string | 必填。模型标识符。设为 openai/gpt-image-2.6-sunburst。 |
| prompt | string | 必填。描述期望生成图像内容的文本提示。最大长度 9999 字符。 |
| prompt_enhance | string | 可选。控制提示词增强。接受 AUTO、ON 或 OFF。默认为 AUTO。 |
| public | boolean | 可选。布尔标志,决定生成结果是公开(true)还是私有(false)。 |
| quality | string | 可选。接受 LOW、MEDIUM、HIGH、XHIGH 或 MAX。默认为 HIGH。 |
| quantity | integer | 可选。单次请求中生成的图像数量(1-8)。默认为 4。 |
| style_ids | array | 可选。用于将预设艺术风格应用于输出的风格 UUID 数组(限制为 1 种风格)。默认为 111dc692-d470-4eec-b791-3475abac4c46(动态)。请参阅下表。 |
| transparency | boolean | 可选。设为 true 以允许生成透明背景的图像。 |
| width | integer | 可选。宽度输入分辨率。默认为 1024。必须是 16 的倍数,范围在 16 到 3840 之间。长边最多可以是短边的三倍。常用值见下文相关章节。 |
宽高比设置
| 宽高比 | 宽度 | 高度 |
|---|---|---|
| 1:1 | 1024 | 1024 |
| 2:3 | 848 | 1264 |
| 3:2 | 1264 | 848 |
| 16:9 | 1376 | 768 |
| 9:16 | 768 | 1376 |
分辨率限制
- 仅限 16 的倍数
宽度和高度都必须是 16 的倍数,范围从 16 到 3840。 最大比例 3:1
长边最多不能超过短边的三倍。 不支持自动尺寸
宽度和高度不能传 0,也不支持 size: "auto",不能把这个值传给 API。 风格 ID 列表 预设风格UUID3D Renderdebdf72a-91a4-467b-bf61-cc02bdeb69c6Acrylic3cbb655a-7ca4-463f-b697-8a03ad67327cCinematica5632c7c-ddbb-4e2f-ba34-8456ab3ac436Creative6fedbf1f-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-1e82dad0ffa1Portraitab5a4220-7c42-41e5-a578-eddb9fed3d75Portrait 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-992a30824a2cVibrantdee282d3-891f-4f73-ba02-7f8131e5541bWatercolor1db308ce-c7ad-4d10-96fd-592fa6b75cc4更新于 9 天前,这个页面对你有帮助吗?
上一篇
第16章 通过 Leonardo.AI API 使用 GPT Image 2.6 Flare 生成图像
下一篇
第18章 使用 Leonardo.AI API 调用 Ideogram 3.0 图像生成指南