进阶 docs.leonardo.ai 2026-11-22 15:11:20 · 0 阅读
第66章 Leonardo.AI API 集成常见问题解答
# 第66章 常见问题(FAQ)
## 一般常见问题
通过 API 集成 Leonardo.Ai 时的常见问题解答。
## 模型
### API 上有哪些可用模型?
查看各模型的具体实现细节:
- 浏览我们的 Generation 指南,每个模型都有专属指南,包含参数、示例和最佳实践。
- 使用 Leonardo 应用中的 Get API Code 功能——先用你的模型生成图片,然后点击 "Get API Code" 即可查看具体实现代码(了解更多)。
### 在哪里可以找到常用 API 取值列表?
请参考这份列表来查找常用的 API 取值。
### 在哪里可以找到某个平台模型的 Model ID?
查找 Leonardo.Ai 平台模型 ID 有多种方法:
- 使用这个 List Platform Models 接口列出所有平台模型,你可以在返回结果中看到所有公开模型的 id、名称和描述。
- 使用 Leonardo 应用中的 Get API Code 功能——先用你的模型生成图片,然后点击 "Get API Code" 查看具体实现代码,其中包含 Model ID(了解更多)。
- 另一种方法是进入 Leonardo 应用,选择 Finetune Models,切换到 Platform Models 标签页,点击对应模型后再点击 View More,即可看到该模型的 Model ID。
### 我可以在 Leonardo API 中使用自己的自定义模型吗?
可以,你可以在 Leonardo API 中使用自己的自定义模型。
### 如何找到我的自定义模型 ID?
在 Leonardo 应用中进入 Finetune Models,切换到 Your Models 标签页,点击对应模型后再点击 View More,即可看到该自定义模型的 Model ID。
## 图像生成
### 调用 Get a Single Generation API 时,图片 URL 数组是空的 "generated_images": []
当 Get a Single Generation 接口的响应为空(即 "generated_images": [])时,原因通常是生成尚未完成。你可以查看 status 参数确认,此时它会显示 PENDING。
```json
{
"generations_by_pk": {
"generated_images": [],
...
"status": "PENDING",
...
}
}
```
图像生成需要几秒钟时间,因此你需要实现等待和重试逻辑,直到 status 变为 COMPLETE 或 FAILED。
另外,Leonardo.Ai 提供了 webhooks 功能。你可以在创建 API key 时指定自己的 webhook。图片生成完成后,Leonardo.Ai 会回调你的 webhook,并附带图片 URL。详情请参考这篇最佳实践指南:Guide to the Webhook Callback Feature。
### 如何指定生成图片的数量?
在 API 请求体中使用 "num_images" 参数。例如只生成 1 张图片,请求体可以这样写:
```json
{
"height": 512,
"modelId": "6bef9f1b-29cb-40c7-b9df-32b51c1f67d3",
"prompt": "An oil painting of a cat",
"width": 512,
"num_images": 1
}
```
### 图片生成应该多久轮询一次?
与其轮询,最佳实践是设置 webhook 回调,让 Leonardo.Ai 在生成完成后主动通知你去获取结果。
你可以在创建新的 Leonardo.Ai Production API key 时设置 webhook 回调 URL 和认证信息。
通过 API 生成的图片会过期吗? 不会。通过 Leonardo.Ai API 生成的图片不会过期,随时都可以在网页版应用中查看。 生成 Motion 视频 为什么生成 SVD motion 时会出现 Service Error? Service Error 虽然是一个通用错误提示,但在这种情况下,通常是使用了错误的 ID 导致的。请确认你用的不是创建图片生成 API 返回的 generationId,而是 Get a Single Generation 接口返回的 Image Id。正确流程是:先把 generationId 传给 Get a Single Generation 接口,再用返回的 image Id 去调用 Create SVD Motion Generation API。 上传图片 如何上传图片用于图生图? 使用 Upload Init Image API。该接口会返回一个 image ID,把它填入创建图片生成 API 的 init_image_id 参数即可。注意,使用 init_image_id 时需要同时设置 isInitImage:true。 如需图文并茂的上传图片教程,请参考对应的操作指南。 如何上传图片用作 image prompt? 同样使用 Upload Init Image API,该接口返回的 image ID 填入创建图片生成 API 的 imagePrompts 参数即可。 具体操作步骤请参考相关指南。 注意:imagePrompts 参数接受的是由 image ID 组成的数组。 示例 1:单个 image prompt: imagePrompts: [“XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX1”] 示例 2:两个 image prompts: imagePrompts: [XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX111, XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX222] Upload Init Image API 中的 extension 参数是什么? extension 参数是指要上传图片的文件扩展名,仅支持 png、jpg、jpeg、webp 这几种。该参数不接受完整文件名或二进制图片数据。 init_generation_image_id 和 init_image_id 有什么区别? init_generation_image_id 接受的是在 Leonardo.Ai 上生成的图片 ID,这类 ID 可通过 Get Generations by User ID 和 Get a Single Generation 等接口获取。 init_image_id 接受的是 Upload Init Image API 返回的图片 ID。 Variations 如何通过 API 放大图片? 使用 Variation: Create Upscale API 即可放大图片。该功能会对图片应用 'Creative Upscale'(创意放大)。 进行 upscale、unzoom 等变换时,图片 ID 从哪里获取? 图片 ID 可通过 Get a Single Generation 或 Get Generations by User ID 接口获取。这些接口会返回包含图片 URL 链接的数组,每个元素都带有 id 属性,这个 id 就是图片 ID。 集成相关 Leonardo 有官方 SDK 吗? Leonardo.Ai 的官方 SDK 如下: Python SDK TypeScript SDK Leonardo 有 Unity 插件吗? 没有,Leonardo.Ai 目前没有官方 Unity 插件。如需了解替代方案,请通过支持渠道或联系表单与我们沟通。 Leonardo 支持与第三方集成应用对接吗? 支持。Leonardo.Ai 已与 Pabbly Connect 和 Make.com 完成集成,使用中的问题请直接咨询这些第三方应用。 API 管理 User API key 去哪了? User API key 已被弃用,由 Production API key 取代。Production API key 可用于所有 API 接口,可在此处生成。已有的 User API key 仍然可用,但新建的 key 都需要以 Production API key 的形式生成。 API Key 的创建数量有限制吗? 每个账户最多可创建 10 个 API Key。如果不再需要某些 Key,可以前往 API Access 页面选择删除。 如何删除我的 API 账户? 你的 Production API 账户与 Leonardo AI 网页版账户绑定,因此无法单独删除 API 账户。 删除 Leonardo AI 账户时,API 账户也会被一并安排删除。删除完成后,数据将被永久移除且无法恢复。最近更新:9 个月前 本页对你有帮助吗?
通过 API 生成的图片会过期吗? 不会。通过 Leonardo.Ai API 生成的图片不会过期,随时都可以在网页版应用中查看。 生成 Motion 视频 为什么生成 SVD motion 时会出现 Service Error? Service Error 虽然是一个通用错误提示,但在这种情况下,通常是使用了错误的 ID 导致的。请确认你用的不是创建图片生成 API 返回的 generationId,而是 Get a Single Generation 接口返回的 Image Id。正确流程是:先把 generationId 传给 Get a Single Generation 接口,再用返回的 image Id 去调用 Create SVD Motion Generation API。 上传图片 如何上传图片用于图生图? 使用 Upload Init Image API。该接口会返回一个 image ID,把它填入创建图片生成 API 的 init_image_id 参数即可。注意,使用 init_image_id 时需要同时设置 isInitImage:true。 如需图文并茂的上传图片教程,请参考对应的操作指南。 如何上传图片用作 image prompt? 同样使用 Upload Init Image API,该接口返回的 image ID 填入创建图片生成 API 的 imagePrompts 参数即可。 具体操作步骤请参考相关指南。 注意:imagePrompts 参数接受的是由 image ID 组成的数组。 示例 1:单个 image prompt: imagePrompts: [“XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX1”] 示例 2:两个 image prompts: imagePrompts: [XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX111, XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX222] Upload Init Image API 中的 extension 参数是什么? extension 参数是指要上传图片的文件扩展名,仅支持 png、jpg、jpeg、webp 这几种。该参数不接受完整文件名或二进制图片数据。 init_generation_image_id 和 init_image_id 有什么区别? init_generation_image_id 接受的是在 Leonardo.Ai 上生成的图片 ID,这类 ID 可通过 Get Generations by User ID 和 Get a Single Generation 等接口获取。 init_image_id 接受的是 Upload Init Image API 返回的图片 ID。 Variations 如何通过 API 放大图片? 使用 Variation: Create Upscale API 即可放大图片。该功能会对图片应用 'Creative Upscale'(创意放大)。 进行 upscale、unzoom 等变换时,图片 ID 从哪里获取? 图片 ID 可通过 Get a Single Generation 或 Get Generations by User ID 接口获取。这些接口会返回包含图片 URL 链接的数组,每个元素都带有 id 属性,这个 id 就是图片 ID。 集成相关 Leonardo 有官方 SDK 吗? Leonardo.Ai 的官方 SDK 如下: Python SDK TypeScript SDK Leonardo 有 Unity 插件吗? 没有,Leonardo.Ai 目前没有官方 Unity 插件。如需了解替代方案,请通过支持渠道或联系表单与我们沟通。 Leonardo 支持与第三方集成应用对接吗? 支持。Leonardo.Ai 已与 Pabbly Connect 和 Make.com 完成集成,使用中的问题请直接咨询这些第三方应用。 API 管理 User API key 去哪了? User API key 已被弃用,由 Production API key 取代。Production API key 可用于所有 API 接口,可在此处生成。已有的 User API key 仍然可用,但新建的 key 都需要以 Production API key 的形式生成。 API Key 的创建数量有限制吗? 每个账户最多可创建 10 个 API Key。如果不再需要某些 Key,可以前往 API Access 页面选择删除。 如何删除我的 API 账户? 你的 Production API 账户与 Leonardo AI 网页版账户绑定,因此无法单独删除 API 账户。 删除 Leonardo AI 账户时,API 账户也会被一并安排删除。删除完成后,数据将被永久移除且无法恢复。最近更新:9 个月前 本页对你有帮助吗?