개요
설정 > ZenBlocks > API Settings 탭에서 외부 이미지·동영상 검색에 사용할 API 키를 등록합니다. 각 서비스에서 발급받은 키를 입력하면 블록 에디터에서 직접 외부 미디어를 검색하고 삽입할 수 있습니다.
| 서비스 | 이미지 | 동영상 | 라이선스 |
|---|---|---|---|
| Unsplash | O | — | Unsplash License |
| Pexels | O | O | Pexels License |
| Pixabay | O | O | CC0 (퍼블릭 도메인) |
하나의 API 키를 여러 사이트에서 공유하여 사용할 수 있습니다.
외부 미디어 API의 구조
ZenBlocks가 외부 서비스에 접속하는 방식
ZenBlocks는 등록된 API 키를 사용하여 각 서비스에 검색 요청을 보냅니다. 검색 결과는 블록 에디터 내에서 미리보기로 표시되며, 선택한 미디어를 WordPress 미디어 라이브러리에 직접 가져올 수 있습니다.
API 키란
API 키는 외부 서비스에 접근하기 위한 인증 코드입니다. 각 서비스의 개발자 포털에서 무료로 발급받을 수 있습니다.
대상 서비스
| 서비스 | 제공 콘텐츠 | API 키 발급처 |
|---|---|---|
| Unsplash | 고품질 사진 | unsplash.com/developers |
| Pexels | 사진 + 동영상 | pexels.com/api |
| Pixabay | 사진 + 동영상 (CC0) | pixabay.com/api/docs |
서비스별 차이점
- Unsplash — 사진 전문 서비스로, 고해상도 이미지를 제공합니다. 동영상은 지원하지 않습니다.
- Pexels — 사진과 동영상을 모두 제공합니다. Pexels License에 따라 자유롭게 사용할 수 있습니다.
- Pixabay — 사진과 동영상을 CC0(퍼블릭 도메인)로 제공합니다. 저작권 표시 없이 자유롭게 사용할 수 있습니다.
CC0(퍼블릭 도메인)이란
CC0는 Creative Commons Zero의 약자로, 저작권자가 모든 권리를 포기한 라이선스입니다. 상업적 이용, 수정, 배포를 저작권 표시 없이 자유롭게 할 수 있습니다.
설정 순서
다음 5단계로 API 키를 등록합니다.
- 사용하려는 서비스(Unsplash, Pexels, Pixabay)의 개발자 포털에서 API 키를 발급받습니다.
- WordPress 관리 화면에서 설정 > ZenBlocks를 엽니다.
- API Settings 탭을 선택합니다.
- 각 서비스의 API 키 입력란에 발급받은 키를 붙여넣습니다.
- Save 버튼을 클릭하여 저장합니다.
이미지와 동영상의 관계
API 키는 서비스 단위로 등록합니다. 하나의 키를 등록하면 해당 서비스가 제공하는 이미지와 동영상 모두 검색할 수 있습니다. 예를 들어 Pexels API 키를 등록하면 Pexels의 사진과 동영상을 모두 사용할 수 있습니다.
확인 포인트
- API 키 입력 후 Save를 클릭하면 키가 저장됩니다.
- 블록 에디터에서 외부 미디어 검색 기능이 활성화됩니다.
- 검색 결과에 해당 서비스의 미디어가 표시됩니다.
- 미디어를 선택하면 WordPress 미디어 라이브러리에 추가됩니다.
주의 사항
- API 키는 각 서비스의 이용 약관에 따라 사용합니다.
- 무료 플랜의 경우 시간당 또는 일별 요청 횟수 제한이 있을 수 있습니다.
- API 키는 외부에 노출되지 않도록 주의합니다.
- 키를 삭제하면 해당 서비스의 검색 기능이 비활성화됩니다.
문제 해결
API 키를 등록했는데 검색이 되지 않는 경우 다음 순서로 확인합니다.
- API 키가 정확한지 확인합니다. — 키를 다시 복사하여 붙여넣습니다. 앞뒤 공백이 포함되지 않았는지 확인합니다.
- 서비스 상태를 확인합니다. — 해당 서비스의 상태 페이지에서 장애가 발생하지 않았는지 확인합니다.
- 요청 제한을 확인합니다. — 무료 플랜의 요청 횟수 제한에 도달하지 않았는지 확인합니다.
- 브라우저를 새로고침합니다. — 설정 저장 후 에디터를 새로고침하거나 다시 열어봅니다.
서비스 선택 기준
- 사진만 필요한 경우 — Unsplash를 추천합니다. 고품질 이미지를 제공합니다.
- 사진과 동영상 모두 필요한 경우 — Pexels 또는 Pixabay를 추천합니다.
- 저작권 표시 없이 자유롭게 사용하고 싶은 경우 — Pixabay(CC0)를 추천합니다.
- 가능한 한 많은 미디어를 사용하고 싶은 경우 — 세 서비스 모두 등록하는 것을 추천합니다.