Pexels가 새 API 키 발급을 중단했다: 대신 쓸 수 있는 대안
“New API key issuance is currently paused.”(신규 API 키 발급이 현재 일시 중단되어 있습니다.) Pexels가 무엇을 언제 바꿨는지, 이미 코드를 고쳐 쓰고 있는 프로젝트들, 그리고 Pexels·Unsplash·Pixabay 등을 한 번에 검색하는 키 하나로 5분 만에 갈아타는 방법.
API 키를 받으려고 Pexels API 페이지를 열면, 묻기도 전에 페이지가 먼저 답합니다. “New API key issuance is currently paused.” — 채워 넣을 양식도, 올라탈 대기자 명단도, 일정을 잡을 만한 날짜도 없습니다. 수많은 튜토리얼이 “30초면 받는 무료 키”로 소개해 온 API에게, 이 한 문장은 모든 신규 프로젝트, 모든 새 팀원, 그리고 이제 막 연동되려던 모든 AI 에이전트 앞의 정문을 닫아 버립니다.
이 글은 Pexels가 무엇을 언제 바꿨는지를 1차 자료로 확정하고, 누가 이미 영향을 받고 있는지를 공개된 풀 리퀘스트로 보여 주며, 어디에 정착해야 하는지를 따져 봅니다 — 5분이면 그대로 따라 할 수 있는 마이그레이션과 함께. 바쁘시다면 곧바로 갈아타는 방법으로 가세요.
Pexels는 무엇을, 언제 바꿨나
공지 게시글은 찾지 못했습니다. 안내 문구는 이미 있던 페이지의 맨 위에 그냥 나타났습니다. 나란히 놓고 읽으면 이렇게 되어 있습니다.
| 페이지 | 현재 적혀 있는 내용 | 문구 마지막 수정 시점 |
|---|---|---|
pexels.com/api |
“New API key issuance is currently paused.” | 2026년 9월 28일~10월 4일 사이1 |
| 도움말 센터 · How do I get an API key?(API 키는 어떻게 받나요?) | “New API key issuance is currently paused.” — 예전 안내문 바로 위에 붙어 있는데, 그 안내문은 지금도 “You'll receive your API key immediately.”(API 키를 바로 받으실 수 있습니다.)로 끝납니다. | 2026년 9월 30일 19:14 UTC2 |
| 도움말 센터 · How do I get unlimited requests?(무제한 요청은 어떻게 받나요?) | “API rate limit increases are currently paused.” 기본 한도는 시간당 200회, 월 20,000회 요청입니다. | 2026년 9월 30일 19:15 UTC |
| 도움말 센터 · Do I have to pay for higher limits?(더 높은 한도를 쓰려면 비용을 내야 하나요?) | “API rate limit increases are currently paused.” | 2026년 9월 30일 19:13 UTC |
| 도움말 센터 · How do I change my API key?(API 키는 어떻게 변경하나요?) | “API keys can't be changed by you”(API 키는 직접 변경할 수 없습니다) — 새 키를 요청하거나 기존 키를 취소하려면 [email protected]으로 이메일을 보내야 합니다. |
2026년 9월 30일 19:04 UTC |
| API 문서 | 계정이 있는 사람이라면 누구나 키를 신청할 수 있고, 그 키를 “which you will receive instantly”(즉시 받게 됩니다)라고 지금도 적어 두고 있습니다. | 업데이트되지 않음 |
2026년 10월 14일에 확인했습니다. 각 날짜를 어떻게 확정했는지는 각주에 있습니다.
타임스탬프가 맞아떨어집니다. 도움말 센터 문서 네 편은 모두 9월 30일 UTC 19:04부터 19:15 사이에 수정되었습니다. Wayback Machine이 9월 28일에 저장한 API 페이지에는 이 공지가 없고 10월 4일에 저장한 것에는 있으며, 이 문구를 인용한 첫 공개 GitHub 이슈는 10월 1일에 열렸습니다. Pexels는 이유도 일정도 밝히지 않았고, 2주가 지난 지금도 공지는 그대로 걸려 있습니다. 따라잡지 못한 것은 API 문서뿐입니다. 이 문서는 여전히 “즉시 받게 되는” 키를 설명하고 있는데, 이는 신규 사용자가 더 이상 얻을 수 없는 바로 그것입니다.
누가 영향을 받나
네 부류가 가장 먼저 충격을 느낍니다.
-
새로 무언가를 시작하는 모든 사람. 사이드 프로젝트, 해커톤 출품작, 강의 실습, MVP.
10월 이전에 쓰인 모든 Pexels 튜토리얼은 이제 통하지 않는 단계로 시작하고,
PEXELS_API_KEY를 요구하는 모든 오픈소스 도구의 설정도 마찬가지입니다. 10월 1일에는 오픈소스 YouTube 자동화 프로젝트를 실행해 보려던 누군가가, 자신이 부딪힌 벽을 그대로 제목으로 단 이슈를 열었습니다. “Request API Access New API key issuance is currently paused. in Pexels” (Pexels API 접근 신청: 신규 API 키 발급이 현재 일시 중단되어 있습니다.). - 키가 하나 더 필요했던 팀. Pexels는 계정당 키를 하나만 발급하고, 사용자가 직접 바꿀 수도 없습니다. 새 클라이언트, 운영 환경용 별도 키, 팀원의 샌드박스. 예전에는 그때마다 새 계정을 만들고 새 키를 받으면 됐습니다. 그 길은 막혔습니다.
- 성장 중인 제품. 상향이 중단된 지금, 키 하나의 상한은 시간당 200회, 월 20,000회 요청입니다. 하루 1,000번 검색하면 한 달 한도는 20일째에 바닥나는데, 지금은 한도를 더 늘려 줄 양식조차 없습니다.
- 자동화와 AI 에이전트. 숏폼 영상 생성기, 블로그 자동 발행 파이프라인, “스톡 사진 한 장을 추가”해 주는 에이전트는 실행할 때마다 사진 API를 호출합니다. 아래에 소개하는 프로젝트 중 여럿이 바로 그런 도구입니다. 사진 단계에서 키를 받지 못하면 파이프라인 전체가 멈춥니다.
공개적으로 벌어진 2주간의 코드 교체
GitHub의 공개 이슈와 풀 리퀘스트에서 이 공지와 그 변형 표현을 검색했습니다. 10월 1일부터 13일 사이에 15건이 Pexels의 중단을 변경 사유로 들었습니다3. 이들이 대신 선택한 방법은 시사하는 바가 큽니다.
| 프로젝트가 한 일 | 건수 | 당사자들의 표현 |
|---|---|---|
| Pixabay 도입 | 9 | “Swap meal-photo lookup from Pexels to Pixabay — Pexels has paused new API keys”(식사 사진 조회를 Pexels에서 Pixabay로 교체 — Pexels가 신규 API 키 발급을 중단함) |
| Wikimedia Commons로 이전 | 1 | “Pexels was the original plan, but Pexels has paused new API keys.”(원래 계획은 Pexels였지만, Pexels가 신규 API 키 발급을 중단했다.) |
| 보류하거나 공백을 문서화 | 5 | “PEXELS_KEY waits until they reopen”(PEXELS_KEY는 재개될 때까지 대기) |
Pixabay는 가장 먼저 떠오르는 반사적 선택입니다. 로그인하면 바로 키가 나오고, 분당 100회 — 시간당 6,000회 — 요청을 허용합니다. 하지만 키 교체는 결코 키 교체로 끝나지 않습니다. Pixabay의 API 약관은 영구적인 핫링크를 금지하고 — “please download them to your server first”(먼저 여러분의 서버로 내려받으세요) — API 응답을 24시간 캐싱하도록 요구하기 때문에, 갈아타는 풀 리퀘스트는 결국 스토리지와 캐시, 재호스팅 단계를 추가하게 됩니다. 그중 하나는 이렇게 숨김없이 적었습니다. “Pixabay photos are downloaded and re-hosted.”(Pixabay 사진은 내려받아 재호스팅한다.) 게다가 이런 교체는 하나같이 카탈로그를 다른 카탈로그로 맞바꾸는 일이기도 합니다. 사진작가 구성도, 분위기도 달라지고, 제품이 애초에 바탕으로 삼아 설계한 검색 결과는 하나도 남지 않습니다. (한 프로젝트는 다른 길을 택해, 공급자 체인에 Pixabay와 나란히 Pexafy를 추가했습니다.)
이런 일이 처음은 아닙니다. 2024년에 Unsplash가 source.unsplash.com을 끈 뒤에도, 수정 작업은
2년이 지나도록 계속 반영되고 있었습니다 — 이는
source.unsplash.com 부검 보고서에서
직접 측정했습니다. 무료 사진 API는 저마다의 일정에 따라 약관을 바꿉니다. 정작 유용한 질문은 다음에 어느
라이브러리 하나에 걸지가 아니라, 제품의 얼마만큼을 그중 어느 하나에 의존하게 둘 것인가입니다.
지금 선택할 수 있는 방법
| 선택지 | 오늘 키를 받을 수 있나? | 무료 한도 | Pexels 사진? | 요구되는 것 |
|---|---|---|---|---|
| Pexels 재개를 기다림 | 불가 중단 상태, 재개 일정 없음 | — | 있음(언젠가 재개되면) | 아무도 공개하지 않은 날짜에 좌우되는 로드맵 |
| Pixabay API | 가능(로그인 후) | 시간당 6,000회 요청 | 없음 | 이미지를 내려받아 재호스팅하고, 응답을 24시간 캐싱하며, 사용자에게 이미지 출처를 표시 |
| Unsplash API | 가능(데모 모드) | 데모 모드에서 시간당 50회 요청, 승인 후 1,000회 | 없음 | API 가이드라인 준수(핫링크, 출처 표기, 다운로드 보고) |
| Openverse | 불필요 | 익명 사용, 속도 제한 있음 | 없음 | 크리에이티브 커먼즈 라이선스(각각 고유한 출처 표기 조건) |
| Pexafy | 가능 가입 즉시, 카드 불필요 | 월 5,000회 요청, 시간당 최대 1,200회 | 있음 Unsplash, Pixabay 등과 함께 | 키 하나. 각 사진은 출처 라이브러리의 라이선스를 그대로 유지 |
요청 수는 시간당 기준으로 환산했습니다(Pixabay 문서상 분당 100회). Pixabay와 Unsplash의 규칙은 2026년 10월 14일 기준 각 API 문서에서, Openverse는 10월 11일에 확인한 내용을 따랐습니다. 할당량을 같은 단위로 환산한 비교와 10개 항목 전체 비교표는 무료 스톡 사진 API 비교에서 확인하세요.
왜 Pexafy로 갈아타야 하나
위 표의 다른 행은 모두 라이브러리 하나를 다른 라이브러리 하나로 바꾸는 방법입니다. Pexafy는 통합 작업 자체를 대체합니다. 실제로는 이런 의미입니다.
- 키가 오늘 바로 작동합니다. Google, GitHub 또는 이메일 주소로 가입하고, 대시보드에서 키를 만들면 첫 요청이 바로 통과합니다.
-
Pexels 카탈로그는 그대로, 다른 카탈로그까지 더해집니다. Pexafy는 수백만 장의 Pexels 사진을
Unsplash, Pixabay 및 나머지 9개 라이브러리와 함께 하나의 인덱스에 담고 있습니다.
쿼리 한 번이면 어느 라이브러리에서 왔든 가장 잘 맞는 결과가 중복 제거되어 돌아오며, 각 결과에는 출처와
사진작가, 원본 페이지 링크가 붙어 있습니다. 라이브러리 하나만 필요하다면
source파라미터로 제공처별 필터링이 가능합니다. - 요청의 뜻을 이해하는 검색 결과. 키워드 기반 API는 입력한 단어를 태그와 대조하기 때문에 단어를 더할수록 결과가 줄어듭니다. Pexafy는 의미를 기준으로 순위를 매깁니다. 장면을 온전한 한 문장으로 — 최대 500자, 100개 이상의 언어 중 어느 것이든 — 묘사하면, 디테일이 결과를 비우는 대신 더 날카롭게 다듬어 줍니다. 이 페이지 맨 위의 사진이 바로 그런 문장의 검색 결과 1위입니다(검색문은 영어 그대로입니다): a stressed programmer with a hand on the forehead, staring at a laptop covered in php, git and node stickers. 원리는 시맨틱 이미지 검색 vs 키워드 검색에서 다룹니다.
-
어느 라이브러리든 스키마는 하나입니다. 모든 결과에 바로 쓸 수 있는
출처 표기 문구(
attribution.html과attribution.plain)가 붙어 있어, 사진작가와 라이브러리를 표기하는 일은 코드 한 줄이면 됩니다. - 공개된 가격으로, 성장할 여지가 있습니다. Pexels가 방금 중단한 것 — 더 많은 요청 — 이 여기서는 이메일이 아니라 요금표입니다. 바로 아래에 있습니다.
- AI 에이전트를 위한 준비. 이미지로 검색하고(사진을 보내면 모든 라이브러리에서 비슷한 사진을 돌려줍니다), Claude, ChatGPT, Cursor, VS Code 등의 에이전트가 직접 사진을 검색하고 출처까지 표기할 수 있게 해 주는 호스팅형 MCP 서버를 제공합니다. 위에서 갈 곳을 잃은 프로젝트 여럿이 하던 일이 정확히 이것입니다. 클라이언트별 설정은 MCP 페이지에, 그 배경에 있는 생각은 AI 에이전트를 위한 이미지 검색 인프라에 있습니다.
| 요금제 | 월 요금 | 월간 요청 수 | 시간당 요청 수 |
|---|---|---|---|
| Pexels, 기본 키 상향 중단 | $0 | 20,000 | 200 |
| Pexafy Free | $0 | 5,000 | 1,200 |
| Pexafy Starter | $5 | 25,000 | 1,800 |
| Pexafy Pro | $19 | 250,000 | 3,600 |
| Pexafy Team | $59 | 1,000,000 | 12,000 |
| Pexafy Business | $99 | 2,000,000 | 18,000 |
| Pexafy Enterprise | $249 | 5,000,000 | 30,000 |
Pexafy 행은 저희 요금제 카탈로그에서 실시간으로 불러옵니다. 연간 결제 시 더 저렴합니다 — 요금제를 참고하세요. Pexafy는 한도를 분 단위로 적용하므로 시간당 수치는 그 한도를 60분으로 환산한 값입니다(Free: 분당 20회, 시간당 최대 1,200회). Pexafy의 요청 한 번은 모든 라이브러리를 동시에 검색합니다.
갈아타기 전에 알아 둘 점이 하나 있습니다. 무료 요금제는 월 5,000회 요청으로, 기본 Pexels 키보다 적습니다. 다만 그 요청 하나하나가 모든 라이브러리를 동시에 검색합니다. 또한 Starter 요금제는 월 $5에 25,000회까지 늘려 줍니다. 그리고 모든 사진은 출처 라이브러리의 라이선스를 그대로 유지합니다. Pexafy는 이들 라이브러리 위에서 동작하는 독립적인 검색 엔진이자 API일 뿐 저작권자가 아니며, Pexels와도 제휴 관계가 아닙니다.
5분 만에 갈아타기
1 · 키 발급받기
무료 계정을 만든 다음, 대시보드에서
API 키를 만드세요. 키는 서버의 환경 변수
— PEXAFY_API_KEY — 에 넣고, 브라우저 코드에는 절대 넣지 마세요.
2 · 요청 하나 바꾸기
# Before: Pexels
curl -H "Authorization: $PEXELS_API_KEY" \
"https://api.pexels.com/v1/search?query=neon+sign&per_page=15"
# After: Pexafy — say what you want to see, in a sentence
curl -H "X-Api-Key: $PEXAFY_API_KEY" \
"https://api.pexafy.com/api/v1/search/photos?q=a+developer+staring+at+a+laptop+in+frustration&per_page=15"
그다음 읽어 오는 필드 이름을 바꿉니다. 지금까지 쓰던 모든 필드에는 그대로 대응하는 필드가 있습니다.
| Pexels | Pexafy | 비고 |
|---|---|---|
Authorization: <key> | X-Api-Key: <key> | 헤더 이름만 다름 |
query | q | 최대 500자, 완전한 문장이 가장 잘 작동 |
orientation, color | orientation, color_name 또는 color_hex | orientation 값은 동일 |
locale | — | 필요 없음: 모든 언어, 인덱스 하나 |
page, next_page | cursor, pagination.next_cursor | 커서 방식 페이지네이션, per_page는 최대 100 |
photos[] | data[] | |
id | photo_id | 정수가 아니라 문자열 |
src.original · large2x · large · medium · small | urls.full · large · regular · small · thumb | 가장 가까운 크기, 큰 것부터 작은 것 순 |
url | source_image_url | 해당 사진의 출처 라이브러리 내 페이지 |
photographer, photographer_url | photographer_full_name, photographer_url | |
avg_color | color_hex | 이름이 있는 color_name도 추가 |
alt | alt_description | |
| — | source, license_type, attribution | 신규: 출처, 라이선스, 바로 쓸 수 있는 출처 표기 문구 |
3 · 아니면 Pexels 형식 코드를 그대로 두기
프런트엔드가 이미 photos[].src.large를 읽고 있다면 건드리지 마세요. 서버에 아래 어댑터를
두면 됩니다. Pexafy를 호출해 Pexels 형식으로 돌려주고, Pexels가 한 번도 제공하지 않은 필드 두 개를 더해 줍니다.
const ENDPOINT = "https://api.pexafy.com/api/v1/search/photos";
export async function searchPhotos(query, { perPage = 15, cursor } = {}) {
const url = new URL(ENDPOINT);
url.searchParams.set("q", query);
url.searchParams.set("per_page", String(perPage));
if (cursor) url.searchParams.set("cursor", cursor);
const res = await fetch(url, { headers: { "X-Api-Key": process.env.PEXAFY_API_KEY } });
if (!res.ok) throw new Error(`Pexafy ${res.status}: ${await res.text()}`);
const { data, pagination } = await res.json();
return {
per_page: perPage,
next_cursor: pagination?.next_cursor ?? null, // replaces Pexels' next_page URL
photos: data.map((p) => ({
id: p.photo_id,
width: p.width,
height: p.height,
url: p.source_image_url,
photographer: p.photographer_full_name,
photographer_url: p.photographer_url,
avg_color: p.color_hex,
alt: p.alt_description,
src: {
original: p.urls.full,
large2x: p.urls.large,
large: p.urls.regular,
medium: p.urls.small,
small: p.urls.thumb,
tiny: p.urls.thumb,
},
source: p.source, // "Pexels", "Unsplash", "Pixabay"…
attribution: p.attribution, // { html, plain }: render it as-is
})),
};
}
필터(방향, 색상, 라이선스, 소스), 이미지로 검색, 모든 응답 필드는 API 문서에 있습니다.
이미 Pexels 키가 있다면: 그대로 두고 안전망을 더하세요
-
잃어버리지 마세요. 하나 더 만들 수 없고, 직접 교체할 수도 없습니다. 키 교체나 취소는
[email protected]을 통해야 합니다. 혹시 키를 저장소에 커밋했거나 프런트엔드 코드에 실어 배포한 적이 있다면 긴급 사안으로 다루세요. 교체할 수 없는 유출 키는 다른 누군가가 마음대로 소진할 수 있는 할당량입니다. -
상한선을 지켜보세요. Pexels는 성공 응답에
X-Ratelimit-Limit,X-Ratelimit-Remaining,X-Ratelimit-Reset을 담아 보내고, 한도를 넘으면429로 응답합니다. 상향이 중단된 지금, 그 상한선이 곧 천장입니다. - 넘치는 요청을 받아 줄 경로를 추가하세요. Pexels를 첫 번째 호출로 유지하고, Pexels가 거절하면 Pexafy가 응답하게 하세요. 반대로 뒤집어도 됩니다. Pexafy를 주력으로 삼고(호출 한 번이 이미 Pexels와 다른 라이브러리를 모두 커버합니다) Pexels 키는 백업으로 두는 겁니다.
import os, requests
def search(query, per_page=15):
"""Return [(image_url, credit_line)], from Pexels first, Pexafy past the limit."""
r = requests.get(
"https://api.pexels.com/v1/search",
params={"query": query, "per_page": per_page},
headers={"Authorization": os.environ["PEXELS_API_KEY"]},
timeout=10,
)
if r.status_code != 429: # anything but "over your limit": keep Pexels' answer
r.raise_for_status()
return [(p["src"]["large"], f"Photo by {p['photographer']} on Pexels")
for p in r.json()["photos"]]
r = requests.get(
"https://api.pexafy.com/api/v1/search/photos",
params={"q": query, "per_page": per_page},
headers={"X-Api-Key": os.environ["PEXAFY_API_KEY"]},
timeout=10,
)
r.raise_for_status()
return [(p["urls"]["regular"], p["attribution"]["plain"]) for p in r.json()["data"]]
이번 중단은 언젠가 끝날 수도, 끝나지 않을 수도 있습니다. 어느 쪽이든 지난 2주가 주는 교훈은 2024년에
source.unsplash.com이 남긴 교훈과 같습니다. 라이브러리 하나의 호의에 기대는 사진
기능은 단일 장애 지점이라는 것입니다. Pexafy는 이를 Pexels를 포함한 9개
라이브러리를 아우르는 키 하나로 바꾸고, 의도를 이해하는 검색까지 제공합니다.
무료 키를 받으면 5분 안에 첫 검색을 실행할 수 있습니다.
참고 자료 & 각주
1 https://www.pexels.com/api/의 Wayback Machine 캡처:
2026년 9월 28일 17:42 UTC 캡처에는 중단 공지가 없고, 2026년 10월 4일 03:44 UTC 캡처에는
“New API key issuance is currently paused.”라는 문장이 들어 있습니다(페이지 소스에 세 번).
10월 9일 캡처에도, 10월 14일의 실제 페이지에도 있습니다.
2 도움말 센터의 날짜는 help.pexels.com의 공개 Help Center API
(/api/v2/help_center/en-us/articles/<id>.json)에서 가져왔으며, 문서 본문의 마지막 변경 시점을 뜻하는
edited_at 필드를 기준으로 했습니다. How do I get an API key?
(900004904026): 2026-09-30 19:14:37 UTC. 메타데이터는 10월 14일에 한 번 더 건드려졌지만 본문은 그대로입니다.
How do I get unlimited requests?(900005852323): 19:15:25.
Do I have to pay for higher limits?(900005851863): 19:13:48. How do I change my API
key?(47739416247833): 19:04:12. 모두 9월 30일입니다.
3 GitHub 검색 API(이슈와 풀 리퀘스트), 2026년 10월 14일. 이 공지와 그 변형 표현을 대상으로 9월 28일 이후 생성된 항목을 검색했습니다. 모든 결과를 직접 읽었으며, 다음 15건이 이번 중단을 변경 사유로 들었습니다. youtube-agentic-ai-studio #3 · household-state-engine #469 · forkit #17 · ShortForge #167 · CPRNutrition #4 · themegrill-demo-importer #157 · Youtube_help #2 · ayah-studio #7 · creator-os #18 · Creator #2 · scorsese #900 · autorank #20 · meal-plan #8 · The-better-Jarvis #28 · cav #108. 9건은 Pixabay를 도입했고(ShortForge는 Pexafy를 함께 추가), 1건은 Wikimedia Commons로 옮겼으며, 5건은 문제를 보류하거나 공백을 문서에 남겼습니다. 공개 저장소만 대상이므로 모든 수치는 최소치입니다.
1차 자료, 2026년 10월 14일 확인: Pexels API · Pexels API 문서 · API 키는 어떻게 받나요? · 무제한 요청은 어떻게 받나요? · 더 높은 한도를 쓰려면 비용을 내야 하나요? · API 키는 어떻게 변경하나요? · Pixabay API 문서 · Unsplash API 문서 · Openverse API · Pexafy API 및 MCP 문서. Pexafy 요금제는 요금제 카탈로그에서 실시간으로 불러옵니다.
자주 묻는 질문
Pexels는 지금도 새 API 키를 발급하나요?
기존 Pexels API 키는 아직 작동하나요?
[email protected]을 통해야 합니다) 프런트엔드 코드나 공개 저장소에는 절대 넣지 마세요.Pexels는 언제 API 키 발급을 재개하나요?
Pexels API의 가장 좋은 대안은 무엇인가요?
Pexels API 키 없이도 Pexels 사진을 쓸 수 있나요?
Pexels API에서 Pexafy로 어떻게 마이그레이션하나요?
https://api.pexafy.com/api/v1/search/photos), 인증 헤더(Authorization 대신 X-Api-Key), 그리고 필드 이름입니다 — photos[]는 data[]로, src.large는 urls.regular로, photographer는 photographer_full_name으로 바뀝니다. 본문에 필드별 대응표와 Pexels 형식의 결과를 돌려주는 작은 어댑터가 있어서, 나머지 코드는 그대로 둘 수 있습니다.