进阶 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 个月前更新 此页面对您有帮助吗?
当 API 额度用尽时,系统会阻止你的使用,但这一过程并非绝对精确。在某些预期场景下,余额可能会显示为负数,但系统不会允许 API 额度余额负得过多。
请注意,负数的 API 额度将从下次的 API 额度充值中扣除。为避免额度耗尽,请合理规划用量或设置自动充值。 如果生成失败,我还会被扣除额度吗? 如果你的生成通过 API 失败但已扣除额度,这些额度将自动退还到你的账户中。 如何找到我的 API 订阅计划发票? 我们使用 Paddle.com 作为支付系统,请访问 https://paddle.net/ 并输入你的邮箱以查找收据。支付完成后,发票副本也会自动发送至你的邮箱。 API 管理 用户 API 密钥去哪了? 用户 API 密钥已废弃,现由生产环境 API 密钥取代。该密钥可用于所有 API 端点,并可在此处生成。现有的用户 API 密钥仍然有效,但新生成的密钥需作为生产环境 API 密钥处理。9 个月前更新 此页面对您有帮助吗?