Lovable 한국어 문서
원본 문서 보기

Lovable API: URL로 빌드하기

Lovable API Build with URL 기능은 현재 오픈 Beta로, 간단하고 공유 가능한 URL을 사용하여 Lovable 앱을 빌드하고 공유할 수 있습니다.

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 (boolean): 요청을 자동으로 처리하려면 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 인코딩 오류를 방지하고 링크가 올바르게 포맷되도록 돕습니다.

Build with 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이 너무 깁니다" 오류
  • 불완전한 파라미터 파싱
  • 자동 제출 실패

On this page