BuildliyBuildliy
이용 방법템플릿요금
BuildliyBuildliy

AI와 대화하면서 앱과 웹사이트를 만들어요. 아이디어부터 실제 서비스까지, 코딩은 필요 없어요.

제품

  • 템플릿
  • 요금
  • 변경 내역

수익 만들기

  • 제휴 프로그램
  • 내 링크 받기

자료

  • 문서
  • 지원

회사

  • 소개
  • 문의하기

약관 및 정책

  • 개인정보 처리방침
  • 이용약관
  • 제휴 약관
  • 보안
  • 앱 신고하기

© 2026 Buildliy. 모든 권리 보유.

v1.0

시작하기

  • 환영해요
  • 빠른 시작
  • 계정 만들기
  • 내 대시보드
  • 템플릿으로 시작하기

앱 만들기

  • 프로젝트 워크스페이스
  • Buildliy와 대화하기
  • 계획과 승인
  • AI에게 잘 요청하는 법
  • 이미지와 파일 추가하기
  • 클릭해서 편집하기
  • 버전 기록
  • 디자인과 테마
  • 앱 안의 이미지
  • 프로젝트 지식
  • 코드 보기와 다운로드
  • 빌드 확인 방식

백엔드와 데이터

  • 관리 탭
  • 데이터베이스
  • 사용자 로그인
  • 파일 스토리지
  • 비밀 값과 API 키
  • 이메일 보내기
  • 앱 안의 AI
  • 로그와 오류
  • 내 백엔드 사용하기

연동

  • 커넥터
  • 결제 받기
  • GitHub
  • 원하는 API 연결하기

게시와 성장

  • 앱 게시하기
  • 출시 체크리스트
  • 맞춤 도메인
  • 비밀번호 보호
  • 분석
  • SEO와 공유
  • 호스팅
  • 복제와 이전

계정과 결제

  • 요금제
  • 크레딧과 사용량
  • 팀
  • 계정 설정
  • 친구 초대하기

도움말

  • 문제 해결하기
  • 보안 및 개인정보
  • 키보드 단축키
  • 용어집
  • 자주 묻는 질문
  • 도움 받기

백엔드와 데이터

비밀 값과 API 키

앱이 다른 서비스와 연결될 때 필요한 비공개 키를 저장하고 안전하게 지키는 방법, 그리고 그 키가 미리보기와 실제 앱에 전달되는 방식을 알아봐요.

비밀 값은 앱에는 필요하지만 다른 사람에게는 보이면 안 되는 비공개 값이에요. 보통은 API 키나 토큰이에요. 지도, 날씨, 문자 메시지 같은 서비스에서 앱이 그 서비스를 쓸 수 있도록 주는 비밀번호 같은 코드예요.

비밀 값은 앱 코드에 들어가지 않아요. Buildliy가 암호화해서 따로 보관했다가, 앱의 서버가 실행될 때 전달해 줘요. 그래서 코드에도, GitHub에도, 방문자가 내려받는 페이지에도 절대 나타나지 않아요.

비밀 값은 이렇게 안전하게 지켜져요

  • 저장할 때 암호화돼요. Buildliy는 모든 비밀 값을 저장하기 전에 암호화해요.
  • 서버에서만 쓰여요. 앱의 서버 코드만 비밀 값을 읽을 수 있어요. 방문자의 브라우저로는 절대 보내지지 않아요.
  • 다시 보여주지 않아요. 비밀 값을 저장하고 나면 그 값을 다시 볼 수 없고, 새 값으로 바꾸기만 할 수 있어요.
  • 소유자만 다룰 수 있어요. 프로젝트 소유자만 관리 → 비밀 값에서 비밀 값을 보고 바꿀 수 있어요. 공유된 앱에서는 팀원이 AI의 키 카드에 답할 수는 있지만, 이미 저장된 키를 바꿀 수는 없어요.

AI가 키를 요청할 때

요청한 기능에 키가 필요하면 AI가 잠깐 멈추고 채팅에 카드를 보여줘요. 카드는 두 종류예요.

연결 카드는 Resend, Twilio, Airtable, SendGrid처럼 Buildliy의 커넥터 목록에 있는 서비스를 위한 카드예요. 서비스 이름이 붙은 연결 버튼을 클릭해서 키를 추가하세요. Buildliy는 저장하기 전에 그 키가 서비스에서 제대로 작동하는지 확인하고, 암호화해서 보관하고, 내 계정에 저장해요. 그래서 다른 앱에서도 쓸 수 있어요. 연결이 끝나면 AI가 빌드를 다시 이어가요. 전에 연결한 적이 있지만 이 앱에서는 아직 켜지 않았다면, 버튼에 대신 계속하기와 서비스 이름이 나와요. 이미 연결되어 있고 이 앱에서도 켜져 있다면, AI가 알아서 사용하기 때문에 카드가 보이지 않아요. 나중에 하기를 누르면 아무것도 연결하지 않고 카드가 닫혀요. AI는 커넥터 페이지에서 언제든 서비스를 연결할 수 있다고 알려주고, 다음 메시지를 기다려요. 커넥터를 참고하세요.

키 카드는 그 밖의 모든 키를 위한 카드예요. AI의 질문, 키가 저장될 이름(저장할 이름, 예: WEATHER_API_KEY), 그리고 키를 붙여넣는 입력 칸이 보여요.

  1. 1

    서비스에서 키 받기

    서비스 웹사이트에 로그인해서 API 키를 복사하세요. 카드의 질문에 보통 그 키가 무엇에 쓰이는지 나와 있어요.

  2. 2

    카드에 붙여넣기

    입력 칸에 키를 붙여넣으세요. 붙여넣은 내용을 확인하고 싶다면 눈 모양 아이콘을 클릭하세요. 화면을 공유하기 전에는 꼭 다시 가려 두세요.

  3. 3

    저장 클릭하기

    키가 암호화되어 저장돼요. 카드에도 이렇게 적혀 있어요. "안전하게 암호화해서 저장했어요. 채팅이나 앱 코드에는 절대 나타나지 않아요. 나중에 관리 → 비밀 값에서 바꿀 수 있어요." (팀원에게는 "프로젝트 소유자가 나중에 바꿀 수 있어요."라고 보여요.) 그러면 AI가 그 키를 사용해서 계속 만들어요.

건너뛰기를 클릭하면 아무것도 저장되지 않고, AI는 키 없이 계속 진행해요. 그 키가 필요한 기능은 관리 → 비밀 값에서 키를 추가하기 전까지 작동하지 않아요.

결제 받기는 설정 방식이 달라요. 결제 받기를 참고하세요.

채팅에 키를 붙여넣지 마세요

채팅창에 입력한 내용은 대화에 그대로 저장되고 AI가 읽어요. 비밀 값처럼 가려지거나 암호화되지 않아요. 키는 꼭 키 카드나 관리 → 비밀 값을 통해 넣으세요.

실수로 키를 붙여넣었다면

Buildliy는 채팅창에 비밀 키가 들어 있는지 살펴봐요. Stripe 비밀 키, GitHub 토큰, 비밀번호가 들어 있는 데이터베이스 주소 같은 것들이에요. 키가 들어 있는 메시지는 전송되지 않아요. 대신 키를 붙여넣거나 보내기를 누르는 즉시, 채팅창 위에 비밀 키처럼 보여요라는 제목의 카드가 나타나요. 카드에는 어떤 종류의 키인지가 나오고 키의 대부분은 가려져 있어요. 그리고 이런 선택지가 있어요.

  • 비밀 값으로 저장: 저장할 이름에 적힌 이름(예: STRIPE_SECRET_KEY)으로 관리 → 비밀 값에 저장해요. 이름은 바꿀 수 있어요. 키가 커넥터 목록에 있는 서비스의 것이라면 내 … 커넥터로 저장과 이 앱의 비밀 값으로 저장 중에서 고를 수 있어요. 전자는 Buildliy가 키가 작동하는지 확인한 뒤 내 계정에 저장해서 다른 앱에서도 쓸 수 있게 해요. 공유 워크스페이스에서는 먼저 체크 상자를 선택해서, 이 앱에서 작업하는 팀원들이 그 연결을 쓸 수 있다는 점을 확인해야 해요.
  • 메시지 수정: 커서를 키 위로 옮겨 줘서 키를 지울 수 있게 해요. 키가 들어 있는 동안에는 메시지가 전송되지 않아요.
  • 키가 아니에요. 그냥 보낼게요: 카드가 잘못 알아본 드문 경우에, 메시지를 그대로 보내요.

저장하고 나면 메시지 속 키는 [saved as STRIPE_SECRET_KEY]로 바뀌어서, 나머지 메시지를 안전하게 보낼 수 있어요. 저장은 프로젝트 소유자만 할 수 있어요. 팀원에게는 키 지우기가 대신 보이고, 카드에는 소유자에게 관리 → 비밀 값에 추가해 달라고 부탁하라는 안내가 나와요. 앱이 아직 없는 홈 화면에서는 카드가 일단 키를 지우자고 제안해요.

Stripe 공개 키(pk_…)처럼 원래 공개해도 되는 키는 표시하지 않아요. 비밀 키가 들어 있는 Word, Excel, 텍스트 파일을 첨부하면, 그 키는 AI에게 보이지 않게 가려져요.

주의:

그래도 키가 채팅으로 전송됐다면, 노출된 것으로 생각하세요. 해당 서비스 웹사이트에 가서 새 키를 만들고 예전 키는 삭제한 다음, 새 키를 관리 → 비밀 값에 저장하세요.

비밀 값을 직접 추가, 변경, 삭제하기

  1. 1

    비밀 값 열기

    관리 탭을 열고 비밀 값을 선택하세요.

  2. 2

    새 비밀 값 추가 입력하기

    새 비밀 값 추가에서 이름에는 WEATHER_API_KEY처럼 대문자와 밑줄로 된 이름을, 값에는 키 값을 입력하세요. 어디에 쓰는지 나중에 기억할 수 있도록 설명도 적어 둘 수 있어요. 설명은 꼭 적지 않아도 돼요.

  3. 3

    저장하기

    저장을 클릭하세요. 저장된 비밀 값에 나타나요.

이름은 앱 코드가 사용하는 이름과 같아야 해요. 잘 모르겠다면 AI에게 어떤 이름을 기대하는지 물어보세요.

프롬프트
날씨 위젯이 키를 읽을 때 쓰는 비밀 값 이름이 뭐예요?
  • 비밀 값 바꾸기. 원형 화살표 아이콘(이 비밀 값 교체하기)을 클릭하고, 새 값을 붙여넣은 다음 교체를 클릭하세요. 화면이 넓으면 교체 횟수 열에서 그 비밀 값을 몇 번 교체했는지 볼 수 있어요.
  • 이미 있는 이름으로 저장하기. 이미 저장된 이름으로 비밀 값을 저장하면 예전 값이 바뀌어요. Buildliy가 먼저 물어봐요. 미리보기는 바로 새 값으로 바뀌고, 게시된 앱은 다시 게시하기 전까지 예전 값을 그대로 써요. 이전 것 유지 또는 바꾸기 중에서 고르세요.
  • 비밀 값 삭제하기. 휴지통 아이콘(이 비밀 값 삭제하기)을 클릭하고 확인하세요. 앱이 더 이상 그 값을 쓸 수 없게 돼요. 미리보기는 바로, 게시된 앱은 다음에 게시할 때부터 그래요.

미리보기와 실제 앱에서의 비밀 값

  • 미리보기는 새로 추가하거나, 바꾸거나, 삭제한 비밀 값을 자동으로 반영해요. 다시 빌드할 필요가 없어요.
  • 게시된 앱은 게시할 때 비밀 값을 받아요. 비밀 값을 바꾼 뒤에는 게시된 사이트에서 새 값을 쓰도록 다시 게시하세요. 앱이 게시된 상태라면, 관리 → 비밀 값에서 변경한 뒤나 채팅 카드에서 키를 저장한 뒤에 나오는 메시지가 다시 게시하라고 알려줘요.

비밀 값과 커넥터

둘 다 키를 안전하게 저장해요. 차이는 어디에 저장되고 누가 쓸 수 있느냐예요.

커넥터비밀 값
저장되는 곳Buildliy 계정앱 하나
사용하는 곳기본적으로 내가 만든 모든 앱 (앱 하나에서만 끄려면 관리 → 커넥터에서 끄세요). 팀과 공유한 앱은 그곳에서 켠 뒤에만 사용이 앱만
저장 전 확인예, Buildliy가 서비스에서 키를 테스트해요아니요
이럴 때 좋아요여러 앱에서 쓰는, 커넥터 목록에 있는 서비스그 밖의 모든 키, 또는 앱 하나에만 다른 키를 쓰고 싶을 때

비밀 값과 커넥터의 이름이 같으면, 그 앱에서는 비밀 값이 우선해요. 앱 하나에서 다른 키를 쓰고 싶을 때 쓰기 좋은 방법이에요.

Buildliy가 대신 추가하는 키

일부 기능은 비밀 값을 대신 추가해요. 앱에서 앱 안의 AI를 쓰면 BUILDLIY_API_KEY와 BUILDLIY_API_URL이 보여요. 결제를 받는 앱이라면 BUILDLIY_API_KEY와 BUILDLIY_WEBHOOK_SECRET이 보여요. 방문자가 파일을 업로드하거나 앱이 오류를 보고하는 경우에는 BUILDLIY_API_KEY와 BUILDLIY_API_URL이 보여요. 예약 작업이 있다면 BUILDLIY_CRON_SECRET이 보여요. 이 값들을 바꾸거나 삭제하면 해당 기능이 작동하지 않으니 그대로 두세요.

관련 문서

  • 커넥터
  • 어떤 API든 연결하기
  • 보안과 개인정보
  • 앱 게시하기
이전파일 스토리지다음앱에서 이메일 보내기

아직 해결되지 않았나요? 자주 묻는 질문을 확인하거나 문의해 주세요.

이 페이지의 내용

  • 비밀 값은 이렇게 안전하게 지켜져요
  • AI가 키를 요청할 때
  • 채팅에 키를 붙여넣지 마세요
  • 실수로 키를 붙여넣었다면
  • 비밀 값을 직접 추가, 변경, 삭제하기
  • 미리보기와 실제 앱에서의 비밀 값
  • 비밀 값과 커넥터
  • Buildliy가 대신 추가하는 키
  • 관련 문서

AI에게 질문

Buildliy 문서를 바탕으로 한 답변

무엇을 도와드릴까요?

앱을 만들고, 게시하고, 결제하는 것까지 궁금한 건 뭐든 물어보세요. 답변은 이 문서를 바탕으로 하고, 참고한 페이지 링크도 함께 알려드려요.

이렇게 물어보세요

AI 답변은 틀릴 수 있어요. 링크된 페이지를 꼭 확인해 보세요.