进阶 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"

请求体参数

参数类型定义
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 Sunburst 不使用 strength 参数来处理图像参考。
heightinteger可选。高度输入分辨率。默认为 1024。必须是 16 的倍数,范围在 16 到 3840 之间。长边最多可以是短边的三倍。常用值见下文相关章节。
modelstring必填。模型标识符。设为 openai/gpt-image-2.6-sunburst。
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(动态)。请参阅下表。
transparencyboolean可选。设为 true 以允许生成透明背景的图像。
widthinteger可选。宽度输入分辨率。默认为 1024。必须是 16 的倍数,范围在 16 到 3840 之间。长边最多可以是短边的三倍。常用值见下文相关章节。

宽高比设置

宽高比宽度高度
1:110241024
2:38481264
3:21264848
16:91376768
9:167681376

分辨率限制

  • 仅限 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 天前,这个页面对你有帮助吗?

评论 (0)