외부 API 키 발급·연결
이미지 검색·아이콘 등 일부 기능은 외부 API 키가 필요합니다. 모두 무료이며 발급은 5분 이내.
키 없이도 에디터·업로드·도형 등 핵심 기능은 동작합니다.
한눈에 보기
| 서비스 | 기능 | 키 | 한도 |
|---|---|---|---|
| Iconify | 에디터 아이콘 검색 (100k+) | 불필요 | 무제한 |
| Pexels | 에디터 무료 사진 | 필요 | 시간당 200건 |
| Pixabay | 에디터 사진·일러스트 | 필요 | 일 5000건 |
| SMTP | 메일 주문 알림 발송 | 필요 | 발신 서버 종속 |
| Toss Payments | 결제 | 필요 | 테스트키 무료 |
1. Pexels API 키 발급
시간당 200건, CC0 라이선스 (상업용 무료).
- ①
https://www.pexels.com/api/ 접속
상단 "Get Started" 클릭.
- ②
Pexels 계정 가입 (Google·이메일 가능)
이메일 인증 1회. 즉시 키 발급.
- ③
이메일·앱 설명 입력
앱 이름 "BannerBanana", 설명 "Banner editor with stock photos" 정도.
- ④
API 키 복사
대시보드 상단 'Your API Key' 박스.
- ⑤
.env에 추가
apps/web/.env 파일 끝에 아래 한 줄 추가.
# apps/web/.env PEXELS_API_KEY=여기에_복사한_키
추가 후 pnpm --filter @banner/web dev 재시작 필요.
확인: 에디터 → 이미지 탭 → 무료 사진 → Pexels → 검색.
2. Pixabay API 키 발급
일 5000건, Pixabay Content License (상업용·수정 가능, 인물 사진은 부분 제한).
- ①
https://pixabay.com/api/docs/ 접속
상단 "Sign In" → 가입.
- ②
이메일 인증 후 로그인
- ③
API 문서 페이지 상단의 'Your API Key' 확인
로그인 상태에서만 표시됨.
- ④
키 복사 후 .env 추가
# apps/web/.env PIXABAY_API_KEY=여기에_복사한_키
확인: 에디터 → 이미지 탭 → 무료 사진 → Pixabay → 검색.
Pixabay는 일러스트·벡터까지 검색되므로 디자인 소재 찾기 좋습니다.
3. Iconify — 키 불필요
100,000+ 아이콘 (Material Design, Tabler, Lucide, Heroicons 등 200+ 세트). 키 없이 동작.
✅ 별도 설정 필요 없음. 에디터 → 아이콘 탭에서 검색만 하면 됩니다.
단, iconify CDN 응답 시간은 최초 호출 시 1~2초 걸릴 수 있습니다.
4. 그 외 운영용 키
📧 SMTP (메일 발송)
메일 주문 접수 시 운영자에게 자동 알림.
SMTP_HOST=smtp.example.com SMTP_PORT=587 SMTP_USER=noreply@yourdomain.com SMTP_PASS=******** MAIL_ORDER_RECIPIENT=order@yourdomain.com
Gmail SMTP, AWS SES, Mailgun 등 — 발신 서비스 가이드 참고.
💳 Toss Payments
결제·환불.
TOSS_CLIENT_KEY=test_ck_... TOSS_SECRET_KEY=test_sk_...
developers.tosspayments.com — 가입 → 테스트 키 즉시 발급.