URL 파라미터로 프롬프트와 참조 이미지·웹 페이지를 전달해 Lovable 앱 생성을 프로그래매틱하게 자동화합니다.
Lovable API: URL로 빌드하기
Lovable API Build with URL 기능은 현재 오픈 Beta입니다. 간단한 URL로 Lovable 앱을 빌드하고 공유할 수 있으며, 이제 참조 이미지와 웹 페이지도 지원합니다.
Lovable API Build with URL 기능을 사용하면 URL 파라미터로 프롬프트와 선택적 참조 이미지 또는 웹 페이지를 전달해 애플리케이션을 생성할 수 있습니다. 웹사이트, 내부 도구, 자동화에 임베드하면 사용자가 한 번의 클릭으로 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
파라미터는 쿼리 문자열이 아니라 URL 해시 프래그먼트(# 뒤)에 넣습니다.
https://lovable.dev/?autosubmit=true#prompt=YOUR_PROMPT&images=IMAGE_URL&html=PAGE_URL파라미터
| 파라미터 | 타입 | 설명 | 필수/선택 |
|---|---|---|---|
prompt | string | 빌드할 애플리케이션을 설명하는 텍스트. 최대 50,000자. URL 인코딩을 사용하세요(예: 공백에 %20). 매우 긴 URL은 브라우저 또는 파싱 제약으로 인해 실패할 수 있습니다. | 필수 |
images | string | 시각적 참조로 사용할 공개 접근 가능한 이미지 URL. 여러 개는 키를 반복하세요(images=URL1&images=URL2). 래스터 형식만 지원: JPEG, PNG, WebP. | 선택 |
html | string | 공개 접근 가능한 웹 페이지 URL. Lovable이 페이지를 가져와 레이아웃·콘텐츠·스타일의 참조로 사용합니다. 여러 개는 키를 반복하세요. | 선택 |
첨부 한도
images와html은 링크당 참조 첨부 합계 10개 한도를 공유합니다.- Lovable 서버가 가져오기 때문에 모든
images와htmlURL은 공개http또는https로 접근 가능해야 합니다. Lovable은 비공개·인증 필요·localhostURL을 건너뜁니다. - Lovable은 래스터가 아닌 이미지 URL(예: SVG, GIF)과 잘못된 형식이거나
http(s)가 아닌 URL을 무시합니다. 나머지 링크는 그대로 빌드됩니다.
Lovable Link Generator
Lovable Link Generator를 사용해 원하는 프롬프트, 이미지, 웹 페이지로 앱을 생성하는 공유 가능한 URL을 빌드하세요. URL 인코딩도 처리해 링크가 유효하게 유지됩니다.
- 빌드할 애플리케이션을 설명하는 프롬프트를 입력합니다(최대 50,000자).
- 참조 이미지를 추가합니다. 생성기가 각 이미지를 Lovable 계정에 업로드하고 링크에서 참조하므로, 이미지를 공개적으로 호스팅한 상태로 둘 필요가 없습니다.
- 참조 웹 페이지를 URL로 추가합니다. Lovable이 서버 측에서 가져오므로 각 페이지는 공개적으로 접근 가능해야 합니다.
- 생성된 Lovable URL을 복사하고 공유합니다.
링크 생성에는 Lovable 로그인이 필요합니다. 업로드가 계정에 연결되기 때문입니다. 이미지와 웹 페이지는 링크당 참조 10개 한도를 공유합니다.
Build with URL 예시
기본 앱 생성
https://lovable.dev/?autosubmit=true#prompt=Create%20a%20todo%20app참조 이미지
https://lovable.dev/?autosubmit=true#prompt=Build%20a%20landing%20page%20with%20this%20logo&images=https://img.com/logo.png기존 웹 페이지 참조
https://lovable.dev/?autosubmit=true#prompt=Recreate%20this%20page&html=https://example.com/index.html웹 페이지와 이미지 함께 사용
https://lovable.dev/?autosubmit=true#prompt=Rebuild%20this%20page%20with%20our%20logo&html=https://example.com/index.html&images=https://img.com/logo.png모범 사례
- 프롬프트를 간결하게 유지하고 핵심 기능에 집중하세요.
html에는 일반 HTML 문서로 제공되는 표준 웹 페이지를 지정하세요. 인식 가능한 HTML 구조가 없는 페이지는 Lovable이 건너뛸 수 있습니다.- 모든 이미지와 페이지 URL이 공개적으로 접근 가능한지 확인하세요.
- 최상의 생성 결과를 위해 명확하고 설명적인 언어를 사용하세요.
- 파싱 문제를 피하기 위해 프롬프트와 URL의 특수 문자를 URL 인코딩하세요.
공유 URL의 앱 생성 및 인증 플로우
Build with URL 링크를 클릭하면:
- 로그인 상태라면 워크스페이스를 선택하고 Lovable이 앱을 자동으로 빌드하기 시작합니다.
- 로그아웃 상태라면 먼저 가입하거나 로그인합니다. 인증 후 워크스페이스를 선택하면 원래 프롬프트와 참조를 유지한 채 Lovable이 앱을 자동으로 빌드합니다.
오류 처리
- Lovable은 비공개이거나 래스터가 아닌(
images의 경우) URL, 유효한http(s)가 아닌 참조 URL을 조용히 제외합니다. 앱은 프롬프트와 남은 첨부로 그대로 빌드됩니다. - 매우 길거나 잘못된 형식의 URL은 브라우저 "URL이 너무 깁니다" 오류, 불완전한 파라미터 파싱, 자동 제출 실패를 일으킬 수 있습니다. 프롬프트를 50,000자 한도 내로 유지하고, 긴 입력에는 Link Generator를 사용하세요.
FAQ
어떤 이미지 형식을 참조할 수 있나요? JPEG, PNG, WebP입니다. SVG, GIF 등 다른 형식은 Lovable이 무시합니다.
이미지와 페이지 URL이 공개여야 하나요?
네. Lovable이 서버 측에서 가져오므로 비공개·인증 필요·localhost URL은 건너뜁니다. Link Generator는 이미지를 계정에 업로드해 이 문제를 우회합니다.
하나의 링크에 참조를 몇 개까지 추가할 수 있나요? 이미지와 웹 페이지를 합해 최대 10개입니다.
Link Generator로 웹 페이지를 참조할 수 있나요? 네. 생성기에서 이미지와 함께 웹 페이지 URL을 추가하세요. Lovable이 서버 측에서 가져오므로 각 페이지는 공개적으로 접근 가능해야 합니다.
로그아웃한 사용자가 링크를 클릭하면 어떻게 되나요? 먼저 가입하거나 로그인합니다. 인증 후 워크스페이스를 선택하면 원래 프롬프트와 참조를 유지한 채 앱이 자동으로 빌드됩니다.