跳转到主要内容
Lovable API 的 Build with URL 功能允许你通过在 URL 参数中传递提示词和图片，以编程方式创建应用。这样你就可以将其与网站、内部工具或自动化工作流无缝集成，让用户一键生成 Lovable 应用。 每个链接都会告诉 Lovable 要构建什么，以及（可选）要包含哪些图片——剩下的都由 Lovable 自动完成。 示例： 
https://lovable.dev/?autosubmit=true#prompt=Create%20a%20todo%20app
点击此链接会自动打开 Lovable，并开始创建一个待办事项应用。

​
使用场景

使用 Build with URL API，你可以：
  • 在你的网站或应用中嵌入一个 Build with Lovable 按钮。用户点击按钮后会跳转到 Lovable，并自动生成应用。
  • 通过 URL 与朋友、同事或在社交媒体上分享预设的提示词。
  • 将应用生成流程自动化，并将其纳入内部工作流。
  • 使用带有提示词和参考图像的 URL 快速构建应用原型。
你可以自己构造该 URL，或使用 Lovable Link Generator。更多信息见下文。

​
基础 URL

https://lovable.dev/?autosubmit=true#
autosubmit（布尔类型）：必须设置为 true 才能自动处理请求

​
带参数的 URL

https://lovable.dev/?autosubmit=true#prompt=YOUR_PROMPT_HERE&images=IMAGE_URL_1&images=IMAGE_URL_2

​
参数

参数类型描述必填/可选
promptstring对要构建的应用的文本描述。长度上限为 50,000 个字符。请使用 URL 编码（例如将空格编码为 %20）。由于浏览器或解析限制，超长 URL 可能会导致请求失败。必填
imagesstring最多可提供 10 个已进行 URL 编码的图片 URL 作为参考。图片 URL 必须可被公开访问。支持的格式：JPEG、PNG、WebP。可选
使用 Lovable Link Generator 轻松构建可分享的 URL，这些链接会根据你输入的提示和图片生成应用。
  1. 输入你的提示，用来描述要构建的应用（最多 50k 字符）。
  2. 上传最多 10 个公开的图片 URL（JPEG、PNG 或 WebP）。
  3. 复制生成的 Lovable URL 并分享。
这个工具可以帮助避免 URL 编码错误，并确保链接格式正确。

​
通过 URL 示例构建应用

基础应用生成 
https://lovable.dev/?autosubmit=true#prompt=Create%20a%20todo%20app
单张参考图片 
https://lovable.dev/?autosubmit=true#prompt=Display%20these%20images&images=https://img.com/1.jpg
多张参考图像 
https://lovable.dev/?autosubmit=true#prompt=Display%20these%20images&images=https://img.com/1.jpg&images=https://img.com/2.jpg​

​
最佳实践

  • 保持提示词简洁，并聚焦于核心功能。
  • 使用清晰、具描述性的语言，以获得最佳生成效果。
  • 在合适的情况下加入参考图片，帮助引导生成过程。
  • 确保提示词和图片 URL 中的特殊字符已进行 URL 编码，以避免解析问题。

​
使用共享 URL 的应用创建和身份验证流程

当用户点击 Build with URL 链接时：
  • 已登录用户：选择要用于创建项目的工作区，然后应用会自动开始创建。
  • 未登录用户：会被重定向到注册/登录页面。成功完成身份验证后，选择要用于创建项目的工作区，然后应用会自动开始创建，并保留原始提示和图片。

​
错误处理

如果 URL 过长或格式不正确，你可能会遇到：
  • 浏览器提示“URL 过长”错误
  • 参数解析不完整
  • 自动提交失败