进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读

第15章 通过 Leonardo.AI API 使用 GPT Image 2.5 Sunburst

第15章 GPT Image 2.5 Sunburst

本指南演示如何通过 Leonardo.AI REST API 使用 GPT Image 2.5 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.5-sunburst", "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 <YOUR_API_KEY>" \ --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 Sunburst 不使用 strength 作为图像参考。
heightinteger可选。高度输入分辨率。默认为 1024。请参阅下方表格以获取有效值。
modelstring必需。模型标识符。设置为 openai/gpt-image-2.5-sunburst。
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 Sunburst640, 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:110241024
2:38481264
3:21264848
16:91376768
9:167681376

分辨率约束

仅支持离散值


宽度和高度必须分别是上文“高度和宽度列表”表格中列出的值之一。 不支持自动尺寸
0 不是有效的宽度或高度值,也不支持 size: "auto",不能将该值传给 API。 风格 ID 列表 预设风格UUID3D 渲染(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平面设计 2D(Graphic Design 2D)703d6fe5-7f1c-4a9e-8da0-5331f214d5cf平面设计 3D(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)