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

第67章 Leonardo.Ai 旧版 API 常见问题解答

# 旧版常见问题 以下是通过 API 集成 Leonardo.Ai 时的常见问题解答。 ## 模型 ### PhotoReal 的 model ID 是什么? PhotoReal v1 没有 model ID。 要在生产环境 API 上使用 PhotoReal,需要移除 modelId 参数并启用 photoReal 标志。 示例可参考 Generate Images Using PhotoReal 示例配置。 PhotoReal v2 需要搭配 Leonardo Kino XL、Leonardo Diffusion XL 或 Leonardo Vision XL 模型使用,示例请求见这里。 ### 可以在 Leonardo API 中使用我的自定义模型吗? 可以,你可以在 Leonardo API 中使用自己的自定义模型。 ### 如何找到我的自定义模型 ID? 在 Leonardo 应用中进入 Finetune Models,点击 Your Models 标签页,点击对应模型后再点击 View More,即可查看该自定义模型的 Model ID。 ## 图像生成 ### 如何在 API 上使用 Alchemy v2? Alchemy V2 支持 SDXL 模型,如 Leonardo Vision XL、Leonardo Diffusion XL、AlbedoBase XL 和 KinoXL。使用时只需选择一个 SDXL 模型并将 alchemy 参数设为 true,即可启用 Alchemy v2。 ### 为什么我的 guidance scale 设置没有生效? guidance scale 是高级参数,Leonardo 建议在大多数情况下使用 7。 系统在控制 guidance scale 时会有一些默认行为和限制条件,具体如下: - 未设置时,guidance scale 默认为 7。 - 未使用 Alchemy 时,guidance scale 限制在 1-20。 - 使用 Alchemy 但未使用 SDXL 模型时,guidance scale 限制在 2-30。 - 未使用 Alchemy 且 scheduler 设为 LEONARDO 时,guidance scale 上限为 7。 ### 如何通过 API 将 Prompt Magic V3 设为 RAW 模式? 将 "highContrast": false 即可设为 RAW 模式,效果与 Leonardo 应用中开启 RAW 模式相同。 ### 如何通过 API 设置 Alchemy 的 Resonance? 使用 guidance_scale 参数即可,它对应 UI 上的 resonance 设置。 ### 为什么生成的图像尺寸比我指定的宽高要大? 输入分辨率并不总是等于输出分辨率。开启 Alchemy 和高分辨率时,由于内置的上采样功能,输出分辨率可能比输入大 1.5 倍、1.75 倍、2 倍等。例如:Alchemy v2 的输出尺寸是输入的 1.75 倍;Alchemy v1 是 1.5 倍;Alchemy v1 加高分辨率则是 2 倍。 你可以在 Leonardo 网页应用中观察到这一现象,如下图所示。 ## Motion 生成 ### 生成 SVD motion 时为什么出现 Service Error? 虽然 Service Error 是一个通用的错误信息,但在这种场景下,通常是因为使用了错误的 ID。请确保你用的不是 Create a Generation of Images API 返回的 generationId,而是 Get a Single Generation 返回的 Image Id。正确做法是:先把 generationId 传给 Get a Single Generation,再用返回的 image Id 调用 Create SVD Motion Generation API。 ## API 积分 ### 为什么用 API 积分生成图像的成本与 Web Token 不同? API 调用与网页应用中使用 Web Token 生成的计费方式不同,因此成本会有差异。此外,API 积分不会过期,而订阅 Token 有有效期限。 ### 如何为 API 套餐充值更多 API 积分? 你可以在 Leonardo.Ai 应用中购买即时充值的 API 积分:在左侧菜单进入 API Access,点击 Production API 标签页,然后点击 Top-up Credits 按钮。 ### API 积分会过期吗? 不会,API 积分不会过期。但请注意,只有在 API 套餐订阅有效期内才能使用你的 API 积分。 ### 我还有积分,为什么无法继续调用 API? 请确认你的 API 套餐处于有效状态,因为没有有效的 API 套餐就无法使用积分。 ### 我的 API 积分余额是负数,这正常吗? 正常,API 积分出现负数是正常现象。
​
当 API 额度用尽时,系统会阻止你的使用,但这一过程并非绝对精确。在某些预期场景下,余额可能会显示为负数,但系统不会允许 API 额度余额负得过多。
​
请注意,负数的 API 额度将从下次的 API 额度充值中扣除。为避免额度耗尽,请合理规划用量或设置自动充值。 如果生成失败,我还会被扣除额度吗? 如果你的生成通过 API 失败但已扣除额度,这些额度将自动退还到你的账户中。 如何找到我的 API 订阅计划发票? 我们使用 Paddle.com 作为支付系统,请访问 https://paddle.net/ 并输入你的邮箱以查找收据。支付完成后,发票副本也会自动发送至你的邮箱。 API 管理 用户 API 密钥去哪了? 用户 API 密钥已废弃,现由生产环境 API 密钥取代。该密钥可用于所有 API 端点,并可在此处生成。现有的用户 API 密钥仍然有效,但新生成的密钥需作为生产环境 API 密钥处理。9 个月前更新 此页面对您有帮助吗?

评论 (0)