Lovable한국어 문서

Lovable API Build with URL 기능은 현재 오픈 Beta입니다. 프롬프트와 참조 이미지·웹 페이지가 바로 보낼 수 있게 채워진 상태로 Lovable을 여는 링크를 만듭니다.

Lovable API: URL로 빌드하기

Lovable API Build with URL 기능은 현재 오픈 Beta입니다. 프롬프트와 참조 이미지·웹 페이지가 바로 보낼 수 있게 채워진 상태로 Lovable을 여는 링크를 만듭니다.

Lovable API Build with URL 기능을 사용하면 프롬프트가 이미 작성되어 있고, 선택적으로 참조 이미지와 웹 페이지까지 첨부된 상태로 Lovable을 여는 링크를 만들 수 있습니다. 링크를 연 사람은 미리 채워진 프롬프트를 검토한 뒤 보내기를 클릭해 빌드를 시작합니다. Build with URL은 모든 플랜에서 사용할 수 있습니다.

Build with URL은 API 키 없이 링크에서 프롬프트를 미리 채웁니다. REST로 기존 프로젝트를 프로그래밍 방식으로 관리하려면 Lovable API를 사용하세요.

각 링크는 Lovable에 무엇을 빌드할지, 그리고 선택적으로 무엇을 참조할지를 알려줍니다. 작업 기준이 될 이미지나 레이아웃·콘텐츠를 가져올 라이브 웹 페이지가 참조 대상이 될 수 있습니다. 예를 들어 다음과 같습니다.

https://lovable.dev/#prompt=Create%20a%20todo%20app

이 링크를 열면 할 일 앱 프롬프트가 미리 채워져 바로 보낼 수 있는 상태로 Lovable이 열립니다.

프롬프트 링크는 스스로 빌드를 시작하지 않습니다. autosubmit=true가 포함된 예전 링크도 여전히 작동하지만 Lovable은 이 파라미터를 무시합니다. 프롬프트와 첨부 파일은 프롬프트 입력에 보내지 않은 상태로 열리며, 사람이 보내기를 클릭해야 빌드가 시작됩니다.

사용 사례

프롬프트 링크는 URL을 공유할 수 있는 곳이라면 어디서나 사용할 수 있습니다.

  • 웹사이트나 제품에 Build with Lovable 버튼을 추가합니다. 버튼을 클릭한 사람은 누구나 프롬프트가 바로 보낼 수 있게 채워진 상태로 Lovable을 열게 됩니다.
  • 기존 웹 페이지의 URL을 참조로 전달해 그 페이지를 다시 만들거나 개선합니다.
  • 친구, 동료, 소셜 미디어의 팔로워에게 사전 정의된 프롬프트를 공유합니다.
  • 기존 프로젝트의 채팅으로 바로 연결되는 링크로 변경을 제안합니다. 기존 프로젝트의 채팅 미리 채우기를 참고하세요.

URL을 직접 구성하거나 Lovable Link Generator를 사용할 수 있습니다.

링크 만들기

Lovable 홈페이지 URL에서 시작해 # 기호 뒤에 파라미터를 추가하고 &로 구분합니다. 파라미터는 대부분의 URL처럼 ? 뒤가 아니라 # 뒤에 옵니다.

https://lovable.dev/#prompt=YOUR_PROMPT&images=IMAGE_URL&html=PAGE_URL

파라미터

링크는 세 가지 파라미터를 받습니다.

파라미터타입설명필수 여부
promptstring빌드할 애플리케이션을 설명하는 텍스트. 최대 50,000자. 특수 문자는 URL 코드로 바꾸세요(예: 공백은 %20).필수
imagesstring시각적 참조로 사용할 공개 접근 가능한 이미지 URL. 여러 개는 키를 반복하세요(images=URL1&images=URL2). JPEG, PNG, WebP만 지원하며 URL은 .png나 .jpg 같은 해당 확장자로 끝나야 합니다.선택
htmlstring공개 접근 가능한 웹 페이지 URL. Lovable이 페이지를 가져와 레이아웃·콘텐츠·스타일의 참조로 사용합니다. 여러 개는 키를 반복하세요.선택

참조 한도

Lovable은 images와 html 참조에 다음 한도를 적용합니다.

  • images와 html은 링크당 참조 합계 10개 한도를 공유합니다.
  • Lovable 서버가 콘텐츠를 가져오기 때문에 모든 URL은 공개 http 또는 https로 접근 가능해야 합니다. Lovable은 사설 네트워크나 localhost의 URL을 건너뛰고, 로드에 로그인이 필요한 URL은 제외합니다.
  • Lovable은 지원하지 않는 이미지 형식(예: SVG, GIF), 잘못된 URL, 20MB를 넘거나 가져오기가 너무 느린 참조도 제외합니다. 나머지 링크는 프롬프트와 남은 참조로 그대로 로드됩니다.

기존 프로젝트의 채팅 미리 채우기

프롬프트 링크는 새 프로젝트를 만듭니다. 대신 기존 프로젝트에 변경을 제안하려면 프로젝트 URL에 일반 ? 파라미터로 prompt를 추가합니다.

https://lovable.dev/projects/YOUR_PROJECT_ID?prompt=Add%20dark%20mode%20support

에디터가 열리면 Lovable이 텍스트를 채팅 입력란에 써 넣고 URL에서 파라미터를 제거하므로, 페이지를 새로 고치거나 뒤로 가도 다시 적용되지 않습니다. Lovable은 프롬프트를 자동으로 보내지 않습니다. 링크를 연 사람이 텍스트를 검토하고 보내기를 클릭합니다. 채팅 입력란에 보내지 않은 메시지가 이미 있다면 Lovable은 그 메시지를 유지하고 링크의 프롬프트를 무시합니다. 입력란을 비운 뒤 링크를 다시 열면 프롬프트가 적용됩니다.

공유 프로젝트에서 팀원을 제안한 편집으로 바로 안내하는 것처럼 후속 작업 바로가기로 활용하세요.

Lovable Link Generator를 사용하면 URL을 직접 인코딩하지 않고 프롬프트 링크를 만들 수 있습니다. Lovable이 업로드를 계정에 저장하므로 로그인이 필요합니다.

프롬프트 입력

빌드할 내용을 최대 50,000자로 설명합니다.

참조 이미지 추가

생성기가 각 이미지를 Lovable 계정에 업로드하고 링크에서 그 업로드를 참조합니다.

참조 웹 페이지 추가

각 페이지의 URL을 붙여넣습니다. Lovable 서버가 페이지를 가져오므로 페이지는 공개적으로 접근 가능해야 합니다. 이미지와 웹 페이지는 링크당 참조 10개 한도를 공유합니다.

링크 복사 및 공유

링크를 연 사람은 누구나 프롬프트와 참조가 미리 채워져 바로 보낼 수 있는 상태를 보게 됩니다.

Build with URL 예시

예시 값은 실제 값으로 바꾸세요.

기본 프롬프트 링크

https://lovable.dev/#prompt=Create%20a%20todo%20app

참조 이미지

https://lovable.dev/#prompt=Build%20a%20landing%20page%20with%20this%20logo&images=https://img.com/logo.png

기존 웹 페이지 참조

https://lovable.dev/#prompt=Recreate%20this%20page&html=https://example.com/index.html

웹 페이지와 이미지 함께 사용

https://lovable.dev/#prompt=Rebuild%20this%20page%20with%20our%20logo&html=https://example.com/index.html&images=https://img.com/logo.png

기존 프로젝트의 채팅 미리 채우기

https://lovable.dev/projects/YOUR_PROJECT_ID?prompt=Add%20dark%20mode%20support

모범 사례

안정적인 프롬프트 링크를 위해 다음을 따르세요.

  • 프롬프트를 간결하게 유지하고 핵심 기능에 집중하세요.
  • html에는 표준 웹 페이지를 지정하세요. HTML로 읽을 수 없는 페이지는 Lovable이 건너뛸 수 있습니다.
  • 모든 이미지와 페이지 URL이 공개적으로 접근 가능한지 확인하세요.
  • 최상의 생성 결과를 위해 명확하고 설명적인 언어를 사용하세요.
  • 파싱 문제를 피하기 위해 프롬프트와 URL의 특수 문자를 URL 코드로 바꾸세요.

로그인 또는 로그아웃 상태에서 링크 열기

프롬프트 링크를 연 사람이 보는 화면은 로그인 여부에 따라 다릅니다.

  • 로그인 상태: 프롬프트와 참조가 미리 채워진 상태로 Lovable이 열립니다. 텍스트를 검토하고 보내기를 클릭해 빌드를 시작합니다.
  • 로그아웃 상태, 홈페이지 링크(lovable.dev/#...): 프롬프트는 그대로 즉시 채워집니다. 보내기를 클릭하면 Lovable이 가입 또는 로그인을 요청한 뒤 원래 프롬프트와 참조를 유지한 채 빌드를 시작합니다.
  • 로그아웃 상태, Link Generator 링크: 먼저 가입하거나 로그인하면 프롬프트가 미리 채워져 바로 보낼 수 있는 상태로 나타납니다.

제한 사항

다음 두 가지 한도를 넘으면 링크 전체가 실패할 수 있습니다.

  • Lovable은 50,000자 한도를 넘는 프롬프트를 줄이지 않습니다. 링크 전체를 버리며 프롬프트 입력란은 비어 있는 상태로 남습니다.
  • 매우 긴 URL은 브라우저 길이 제한을 넘을 수 있습니다. 긴 프롬프트에는 Link Generator를 사용하세요.

FAQ

관련 주제

On this page