用途：通过 Leonardo.Ai 官方 Production API 操作静态图像的生成、编辑、参考引导、放大和质量检查，并明确区分原生 Lucid/Phoenix 模型、Leonardo 托管的合作方模型、实时画布接口与旧版接口，因为它们路由和结构不同。
主要能力：原生静态模型生成（POST /api/rest/v1/generations）、上传图像与图生图、当前 controlnets 参考引导、LCM 蒙版修补、Pro Upscaler 放大，以及图像 Element（LoRA）与自定义模型训练。模型可选 Lucid Origin、Lucid Realism、Phoenix 1.0/0.9，strength 与可用参数以当前模型指南及 Get API Code 为准。
使用方式：先整理生产简报（交付物、操作、源媒体与权利、运行方式、预算），默认以保守尺寸生成一张私密预览；任何付费调用前说明路由、模型 ID、设置、样本数、费用估算并等待明确批准。正文示例请求使用 modelId、prompt、negative_prompt、width、height、num_images、contrast、alchemy、ultra、public、seed。上传参考走两步：POST /api/rest/v1/init-image 获取字段，再在两分钟内 multipart 上传到预签名 URL，注意不得向存储主机发送 bearer token。异步任务用 GET /api/rest/v1/generations/{id} 轮询或优先采用 webhook，状态为 PENDING、COMPLETE、FAILED。
适用场景：风格化或写实图像、产品与编辑摄影、多参考构图、蒙版编辑、放大与统一质量检查。
限制：合作方模型（如 FLUX、GPT Image、Ideogram 等）使用 v2 调度结构，不得混用 v1 的 modelId、num_images、styleUUID 或 controlnets；部分尺寸、contrast、alchemy 与模型兼容性在不同官方文档间存在冲突，应以当前型号指南和 Get API Code 校验。文档未给出 webhook 的 HMAC 签名、重试与重放窗口，需保留轮询兜底并做幂等处理。视频、3D、Blueprints、网页编辑器、MCP 代理及非官方 SDK 不在范围内。界面描述已按资料整理。