进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第18章 使用 Leonardo.AI API 调用 Ideogram 3.0 图像生成指南
Ideogram 3.0 本指南介绍如何通过 Leonardo.AI REST API 使用 Ideogram 3.0 模型生成图像。⚠️弃用通知 – mode 参数 mode 参数即将弃用,自 2026 年 5 月 4 日起不再支持。请改用 quality 参数更新你的请求。2026 年 5 月 4 日之后,任何包含 mode 的请求都会返回验证错误并失败。你需要做的事:在 5 月 4 日之前,把 GPT 1.5 和 Ideogram 生成请求中的 mode 替换为 quality,以免服务中断。迁移示例可参考 Deprecations & Changes 页面。
本指南介绍如何通过 Leonardo.AI REST API 使用 Ideogram 3.0 模型生成图像。
Sample Request
curl --request POST \
--url https://cloud.leonardo.ai/api/rest/v2/generations \
--header 'accept: application/json' \
--header 'authorization: Bearer ' \
--header 'content-type: application/json' \
--data '{
"model": "ideogram-v3.0",
"parameters": {
"width": 1024,
"height": 1024,
"prompt": "A dynamically stylish green running shoe dominates the frame, with the text Leonardo, the text boldly emblazoned in white. Against a vivid blue backdrop, the shoe exudes modernity with a hint of motion blur, conveying speed and dynamism. Crisp lines and vibrant hues are subtly softened, capturing the essence of movement",
"quality": "MEDIUM",
"quantity": 2,
"style_ids": [
"111dc692-d470-4eec-b791-3475abac4c46"
]
},
"public": false
}'
Recipe
API 请求端点、Headers、参数
Endpoint
https://cloud.leonardo.ai/api/rest/v2/generations
Headers
--header "accept: application/json" \
--header "authorization: Bearer " \
--header "content-type: application/json"
Body Parameters
参数 | 类型 | 说明
height | integer | 可选。高度输入分辨率。
model | string | 必填。模型标识符,设为 ideogram-v3.0。
prompt | string | 必填。描述希望模型生成什么图像的文本提示词。
prompt_enhance | string | 可选。设为 "ON" 时启用提示词增强,设为 "OFF" 时禁用。
public | boolean | 可选。布尔值,决定生成结果是公开(true)还是私有(false)。
quantity | integer | 可选。单次请求生成的图像数量。
seed | integer | 可选。使用固定 seed,保证多组生成结果的一致性。
style_ids | array | 可选。风格 UUID 数组,用于为输出应用预设艺术风格。
width | integer | 可选。宽度输入分辨率。
quality | string | 可选。可取 TURBO、BALANCED 或 QUALITY。
预设风格列表
预设风格 | UUID
Cinematic | a5632c7c-ddbb-4e2f-ba34-8456ab3ac436
Creative | 6fedbf1f-4a17-45ec-84fb-92fe524a29ef
Dynamic | 111dc692-d470-4eec-b791-3475abac4c46
Fashion | 594c4a08-a522-4e0e-b7ff-e4dac4b6b622
Portrait | ab5a4220-7c42-41e5-a578-eddb9fed3d75
Stock Photo | 5bdc3f2a-1be6-4d1c-8e77-992a30824a2c
Vibrant | dee282d3-891f-4f73-ba02-7f8131e5541b
更新于 5 个月前 本页是否对您有帮助?
更新于 5 个月前 本页是否对您有帮助?
上一篇
第17章 通过Leonardo.AI API调用GPT Image 2.6 Sunburst生成图像指南
下一篇
第19章 使用 Leonardo.AI API 调用 Ideogram 模型生成图像