第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 参数
| 参数 | 类型 | 定义 |
|---|---|---|
| guidances | object | 可选。定义影响生成结果的图像引导输入的物体。 |
| guidances.image_reference | array | 可选。最多 16 张参考图像的数组。每张参考图包含 image.id、image.type(UPLOADED、GENERATED、VARIATION、URL 或 BASE64)以及可选的 order。注意:GPT Image 2.5 Sunburst 不使用 strength 作为图像参考。 |
| height | integer | 可选。高度输入分辨率。默认为 1024。请参阅下方表格以获取有效值。 |
| model | string | 必需。模型标识符。设置为 openai/gpt-image-2.5-sunburst。 |
| prompt | string | 必需。描述希望模型生成何种图像的文字提示。最大长度 9999 个字符。 |
| prompt_enhance | string | 可选。控制提示词增强功能。接受 AUTO、ON 或 OFF。默认为 AUTO。 |
| public | boolean | 可选。布尔标志,决定生成结果是否公开(true)或私有(false)。 |
| quality | string | 可选。接受 LOW、MEDIUM、HIGH、XHIGH 或 MAX。默认为 MEDIUM。 |
| quantity | integer | 可选。单次请求生成的图像数量(1-8)。默认为 4。 |
| style_ids | array | 可选。用于对输出应用预设艺术风格的风格 UUID 数组(限制为 1 种风格)。默认为 111dc692-d470-4eec-b791-3475abac4c46(Dynamic)。请参阅下方表格。 |
| width | integer | 可选。宽度输入分辨率。默认为 1024。请参阅下方表格以获取有效值。 |
高度和宽度列表
| 模型 | 高度 | 宽度 |
|---|---|---|
| GPT Image 2.5 Sunburst | 640, 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, 3584 | 768, 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:1 | 1024 | 1024 |
| 2:3 | 848 | 1264 |
| 3:2 | 1264 | 848 |
| 16:9 | 1376 | 768 |
| 9:16 | 768 | 1376 |
分辨率约束
仅支持离散值
宽度和高度必须分别是上文“高度和宽度列表”表格中列出的值之一。 不支持自动尺寸
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 个月前 此页面有帮助吗?