Pexels đã tạm dừng cấp API key mới. Nên dùng gì thay thế
“New API key issuance is currently paused.” (Việc cấp API key mới hiện đang tạm dừng.) Pexels đã thay đổi gì và khi nào, những dự án đang viết lại code để đi vòng, và cách chuyển trong năm phút sang một key tìm kiếm trên Pexels, Unsplash, Pixabay và nhiều thư viện khác.
Bạn mở trang API của Pexels để lấy key, và trang web trả lời trước cả khi bạn kịp hỏi: “New API key issuance is currently paused.” Không có biểu mẫu để điền, không có danh sách chờ để đăng ký, không có mốc ngày nào để lên kế hoạch. Với một API mà vô số bài hướng dẫn giới thiệu là “key miễn phí lấy được trong ba mươi giây”, chỉ một câu ấy đã đóng sập cửa chính trước mọi dự án mới, mọi đồng đội mới và mọi AI agent sắp được nối vào nó.
Bài viết này xác định, dựa trên nguồn gốc, Pexels đã thay đổi điều gì và khi nào; chỉ ra những ai đã bị ảnh hưởng, kèm các pull request công khai làm bằng chứng; và lập luận nên chuyển sang đâu — cùng một cách chuyển đổi bạn có thể sao chép trong năm phút. Đang vội? Nhảy thẳng tới phần chuyển đổi.
Pexels đã thay đổi gì, và khi nào
Chúng tôi không tìm thấy bài thông báo nào. Các thông báo chỉ đơn giản xuất hiện ở đầu những trang vốn đã có sẵn. Đặt cạnh nhau, chúng nói như sau:
| Trang | Hiện đang ghi gì | Nội dung đổi lần cuối |
|---|---|---|
pexels.com/api |
“New API key issuance is currently paused.” | Giữa 28 tháng 9 và 4 tháng 10 năm 20261 |
| Trung tâm trợ giúp · “How do I get an API key?” | “New API key issuance is currently paused.” — ngay phía trên phần hướng dẫn cũ, phần này vẫn kết thúc bằng “You'll receive your API key immediately.” (Bạn sẽ nhận được API key ngay lập tức.) | 30 tháng 9 năm 2026, 19:14 UTC2 |
| Trung tâm trợ giúp · “How do I get unlimited requests?” | “API rate limit increases are currently paused.” Giới hạn mặc định: 200 request/giờ và 20.000/tháng. | 30 tháng 9 năm 2026, 19:15 UTC |
| Trung tâm trợ giúp · “Do I have to pay for higher limits?” | “API rate limit increases are currently paused.” | 30 tháng 9 năm 2026, 19:13 UTC |
| Trung tâm trợ giúp · “How do I change my API key?” | “API keys can't be changed by you” (bạn không thể tự đổi API key) — muốn xin key mới hoặc hủy key cũ, bạn phải gửi email tới [email protected]. |
30 tháng 9 năm 2026, 19:04 UTC |
| Tài liệu API | Vẫn nói rằng bất kỳ ai có tài khoản đều có thể xin key, “which you will receive instantly” (key mà bạn sẽ nhận được ngay lập tức). | Chưa cập nhật |
Đọc ngày 14 tháng 10 năm 2026. Cách xác định từng mốc thời gian nằm trong phần chú thích.
Các mốc thời gian khớp nhau. Cả bốn bài trong trung tâm trợ giúp đều được sửa trong khoảng 19:04 đến 19:15 UTC ngày 30 tháng 9; thông báo không có trong bản lưu trang API của Wayback Machine ngày 28 tháng 9 nhưng có trong bản ngày 4 tháng 10; và issue công khai đầu tiên trên GitHub trích dẫn nó được mở ngày 1 tháng 10. Pexels không đưa ra lý do hay mốc thời gian nào, và hai tuần sau các thông báo vẫn còn nguyên. Chỉ có tài liệu API là chưa theo kịp: nó vẫn mô tả một chiếc key bạn “will receive instantly” — tức là nhận được ngay — đúng thứ mà người dùng mới không còn lấy được nữa.
Ai bị ảnh hưởng
Bốn nhóm cảm nhận thấy trước tiên:
-
Bất cứ ai đang bắt đầu một thứ mới. Dự án phụ, bài dự thi hackathon, bài tập trên lớp, MVP.
Mọi bài hướng dẫn Pexels viết trước tháng 10 đều mở đầu bằng đúng bước không còn chạy được nữa — và phần cài đặt
của mọi công cụ mã nguồn mở đòi
PEXELS_API_KEYcũng vậy. Ngày 1 tháng 10, một người cố chạy dự án tự động hóa YouTube mã nguồn mở đã mở một issue mà tiêu đề chính là bức tường họ đâm phải: “Request API Access New API key issuance is currently paused. in Pexels” (Yêu cầu quyền truy cập API ở Pexels: việc cấp API key mới hiện đang tạm dừng.) - Các nhóm cần thêm một key nữa. Pexels cấp một key cho mỗi tài khoản, và bạn không thể tự đổi nó. Một khách hàng mới, một key riêng cho production, sandbox của đồng đội: trước đây mỗi việc đó nghĩa là một tài khoản mới và một key mới. Con đường ấy giờ đã đóng.
- Các sản phẩm đang lớn lên. Khi việc nâng hạn mức bị tạm dừng, một key bị chặn ở 200 request mỗi giờ và 20.000 mỗi tháng. Với 1.000 lượt tìm kiếm mỗi ngày, hạn mức cả tháng cạn vào ngày 20 — và hiện chưa có biểu mẫu nào để mua thêm.
- Tự động hóa và AI agent. Các công cụ tạo video ngắn, pipeline tự động viết blog và những agent biết “thêm ảnh stock” đều gọi một API ảnh ở mỗi lần chạy. Nhiều dự án bên dưới chính là như vậy: những công cụ mà cả pipeline đứng khựng khi bước lấy ảnh không xin được key.
Hai tuần viết lại code, ngay trước mắt công chúng
Chúng tôi tìm trong các issue và pull request công khai trên GitHub thông báo này cùng những cách diễn đạt gần giống. Từ 1 đến 13 tháng 10, có 15 trường hợp nêu việc Pexels tạm dừng làm lý do thay đổi3. Những gì họ làm thay thế rất đáng chú ý:
| Dự án đã làm gì | Số lượng | Theo lời của họ |
|---|---|---|
| Chuyển sang Pixabay | 9 | “Swap meal-photo lookup from Pexels to Pixabay — Pexels has paused new API keys” (Chuyển việc tra ảnh món ăn từ Pexels sang Pixabay — Pexels đã tạm dừng API key mới) |
| Chuyển sang Wikimedia Commons | 1 | “Pexels was the original plan, but Pexels has paused new API keys.” (Kế hoạch ban đầu là Pexels, nhưng Pexels đã tạm dừng API key mới.) |
| Gác lại, hoặc ghi nhận khoảng trống | 5 | “PEXELS_KEY waits until they reopen” (PEXELS_KEY sẽ chờ đến khi họ mở lại) |
Pixabay là phản xạ hiển nhiên: key hiện ra ngay khi bạn đăng nhập, và cho phép 100 request mỗi phút — tức 6.000 mỗi giờ. Nhưng đổi key chưa bao giờ chỉ là đổi key. Điều khoản API của Pixabay cấm hotlink vĩnh viễn — “please download them to your server first” (vui lòng tải chúng về máy chủ của bạn trước) — và yêu cầu cache phản hồi API trong 24 giờ, nên các pull request chuyển sang Pixabay rốt cuộc phải thêm nơi lưu trữ, một lớp cache và một bước host lại ảnh. Một trong số đó viết thẳng: “Pixabay photos are downloaded and re-hosted.” (Ảnh Pixabay được tải về và host lại.) Mỗi lần đổi như vậy còn đổi luôn cả một kho ảnh sang kho khác — một nhóm nhiếp ảnh gia khác, một phong cách khác, và không còn những kết quả tìm kiếm mà sản phẩm đã được thiết kế xoay quanh. (Có một dự án chọn hướng khác, thêm Pexafy cạnh Pixabay trong chuỗi nhà cung cấp của mình.)
Chuyện này không có gì mới. Khi Unsplash tắt source.unsplash.com năm 2024, các bản sửa vẫn còn đổ về hai
năm sau — chúng tôi đã đo điều đó trong
bài mổ xẻ
source.unsplash.com của mình. Các API ảnh miễn phí thay đổi điều khoản theo lịch riêng của họ. Câu hỏi hữu ích
không phải là lần tới nên đặt cược vào thư viện nào, mà là bao nhiêu phần sản phẩm của bạn nên phụ thuộc vào bất kỳ
thư viện đơn lẻ nào trong số đó.
Các lựa chọn của bạn hôm nay
| Lựa chọn | Có key hôm nay không? | Gói miễn phí | Có ảnh Pexels không? | Đòi hỏi gì ở bạn |
|---|---|---|---|---|
| Chờ Pexels | Không tạm dừng, không có ngày | — | Có, rồi sẽ có | Một lộ trình phụ thuộc vào một mốc ngày chưa ai công bố |
| Pixabay API | Có, sau khi đăng nhập | 6,000 request/giờ | Không | Tải ảnh về và host lại, cache phản hồi 24 giờ, cho người dùng thấy ảnh đến từ đâu |
| Unsplash API | Có, ở chế độ demo | 50 request/giờ ở chế độ demo, 1.000 sau khi được duyệt | Không | Tuân theo các nguyên tắc API của Unsplash (hotlink, ghi công, báo cáo lượt tải) |
| Openverse | Không cần | Ẩn danh, bị giới hạn tốc độ | Không | Giấy phép Creative Commons, mỗi loại có điều khoản ghi công riêng |
| Pexafy | Có ngay khi đăng ký, không cần thẻ | 5,000 request/tháng, tối đa 1,200/giờ | Có cùng với Unsplash, Pixabay và nhiều nguồn khác | Một key; mỗi ảnh giữ nguyên giấy phép của nguồn |
Các mức giới hạn đã được quy đổi sang request mỗi giờ (Pixabay ghi 100 mỗi phút). Quy tắc của Pixabay và Unsplash được đọc từ tài liệu API của họ ngày 14 tháng 10 năm 2026; Openverse được kiểm tra ngày 11 tháng 10. Để xem hạn mức quy đổi cùng một đơn vị và bảng đầy đủ mười tiêu chí, xem so sánh API ảnh stock miễn phí của chúng tôi.
Vì sao nên chuyển sang Pexafy
Mọi hàng còn lại trong bảng đó đều thay một thư viện bằng một thư viện khác. Pexafy thay chính phần tích hợp. Trong thực tế, điều đó nghĩa là:
- Key của bạn dùng được ngay hôm nay. Đăng ký bằng Google, GitHub hoặc địa chỉ email, tạo key trong dashboard, và request đầu tiên của bạn đi qua.
-
Bạn giữ được kho ảnh Pexels — và có thêm các kho khác. Pexafy lập chỉ mục hàng triệu ảnh Pexels
cạnh Unsplash, Pixabay và các thư viện còn lại trong tổng số 9 thư viện, trong một chỉ mục
duy nhất. Một truy vấn trả về các kết quả khớp nhất dù chúng đến từ đâu, đã loại trùng lặp, mỗi kết quả kèm nguồn,
nhiếp ảnh gia và liên kết tới trang gốc. Chỉ cần một thư viện? Tham số
sourcelọc theo nhà cung cấp. - Kết quả hiểu được yêu cầu. Các API từ khóa so khớp từ của bạn với tag, nên mỗi từ thêm vào đều làm kết quả ít đi. Pexafy xếp hạng theo ý nghĩa: hãy mô tả cảnh bằng một câu đầy đủ — tối đa 500 ký tự, bằng bất kỳ ngôn ngữ nào trong hơn 100 ngôn ngữ — và chi tiết sẽ làm kết quả sắc nét hơn thay vì làm cạn đi. Bức ảnh ở đầu trang này là kết quả đầu tiên cho đúng loại câu như vậy (câu này bằng tiếng Anh): a stressed programmer with a hand on the forehead, staring at a laptop covered in php, git and node stickers. Cơ chế được giải thích trong tìm kiếm ảnh ngữ nghĩa so với từ khóa.
-
Một schema duy nhất, dù thư viện nào. Mỗi kết quả đi kèm dòng ghi công
làm sẵn (
attribution.htmlvàattribution.plain), nên ghi công nhiếp ảnh gia và thư viện chỉ là một dòng code. - Còn chỗ để lớn lên, với mức giá công khai. Thứ Pexels vừa tạm dừng — thêm request — ở đây là một bảng giá, không phải một email. Bảng ở ngay bên dưới.
- Sẵn sàng cho AI agent. Tìm kiếm bằng ảnh — gửi một bức ảnh, nhận ảnh tương tự từ mọi thư viện — và một máy chủ MCP được host sẵn để Claude, ChatGPT, Cursor, VS Code cùng các agent khác tự tìm kiếm và ghi công ảnh: đúng việc mà nhiều dự án đang mắc kẹt ở trên vẫn làm. Cách cài đặt cho từng ứng dụng khách nằm ở trang MCP của chúng tôi, còn lập luận đằng sau nó nằm trong hạ tầng tìm kiếm ảnh cho AI agent.
| Gói | Mỗi tháng | Request / tháng | Request / giờ |
|---|---|---|---|
| Pexels, key mặc định tạm dừng nâng hạn mức | $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 |
Các hàng của Pexafy được đọc trực tiếp từ danh mục gói của chúng tôi; thanh toán theo năm rẻ hơn — xem bảng giá. Pexafy áp giới hạn theo phút, nên con số theo giờ là giới hạn đó trải trên sáu mươi phút (Free: 20 mỗi phút, tối đa 1,200 mỗi giờ). Một request Pexafy tìm kiếm trên mọi thư viện cùng lúc.
Một điều cần biết trước khi chuyển: gói miễn phí là 5,000 request mỗi tháng, ít hơn một key Pexels mặc định — nhưng mỗi request đó tìm kiếm trên mọi thư viện cùng lúc, và gói Starter giá $5 mỗi tháng đưa bạn lên 25,000 request. Và mỗi bức ảnh giữ nguyên giấy phép của thư viện mà nó đến từ: Pexafy là một công cụ tìm kiếm và API độc lập trên các thư viện đó, không phải chủ sở hữu quyền, và không liên kết với Pexels.
Chuyển đổi trong năm phút
1 · Lấy key
Tạo tài khoản miễn phí, rồi
tạo một API key trong dashboard. Đặt nó vào một
biến môi trường — PEXAFY_API_KEY — trên máy chủ của bạn, không bao giờ để trong code chạy trên trình duyệt.
2 · Đổi một request
# 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"
Sau đó đổi tên các trường bạn đọc. Mọi thứ bạn từng dùng đều có tương đương trực tiếp:
| Pexels | Pexafy | Ghi chú |
|---|---|---|
Authorization: <key> | X-Api-Key: <key> | Chỉ đổi tên header |
query | q | Tối đa 500 ký tự; câu đầy đủ cho kết quả tốt nhất |
orientation, color | orientation, color_name hoặc color_hex | Giá trị orientation giữ nguyên |
locale | — | Không cần: dùng ngôn ngữ nào cũng được, một chỉ mục duy nhất |
page, next_page | cursor, pagination.next_cursor | Phân trang bằng cursor; per_page tối đa 100 |
photos[] | data[] | |
id | photo_id | Là chuỗi, không phải số nguyên |
src.original · large2x · large · medium · small | urls.full · large · regular · small · thumb | Kích thước gần nhất, từ lớn nhất đến nhỏ nhất |
url | source_image_url | Trang của bức ảnh trên thư viện gốc |
photographer, photographer_url | photographer_full_name, photographer_url | |
avg_color | color_hex | Kèm thêm color_name dạng tên màu |
alt | alt_description | |
| — | source, license_type, attribution | Mới: ảnh đến từ đâu, giấy phép, dòng ghi công làm sẵn |
3 · Hoặc giữ nguyên code theo dạng Pexels
Nếu front end của bạn đã đọc photos[].src.large, cứ để yên. Đặt adapter này trên máy chủ của bạn: nó gọi
Pexafy và trả về dạng Pexels, cộng thêm hai trường mà Pexels chưa bao giờ cung cấp cho bạn.
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
})),
};
}
Bộ lọc (orientation, màu, giấy phép, nguồn), tìm kiếm bằng ảnh và mọi trường của phản hồi đều có trong tài liệu API.
Đã có key Pexels? Hãy giữ lại — và thêm một lưới an toàn
-
Đừng làm mất. Bạn không thể tạo cái khác, cũng không thể tự xoay vòng nó: thay hoặc hủy key phải
qua
[email protected]. Nếu key của bạn từng bị commit vào một repository hoặc phát hành kèm code front end, hãy coi đó là việc khẩn — một key bị lộ mà bạn không thể xoay vòng là một hạn mức người khác có thể đốt sạch. -
Canh trần hạn mức. Pexels báo
X-Ratelimit-Limit,X-Ratelimit-RemainingvàX-Ratelimit-Resettrong các phản hồi thành công, và trả429khi bạn vượt mức. Khi việc nâng hạn mức bị tạm dừng, trần đó chính là trần. - Thêm lớp dự phòng. Giữ Pexels làm lệnh gọi đầu tiên và để Pexafy trả lời khi Pexels từ chối. Hoặc đảo lại: cho Pexafy làm chính — một lệnh gọi đã bao phủ Pexels và các thư viện khác — và giữ key Pexels làm bản dự phòng.
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"]]
Việc tạm dừng rồi sẽ kết thúc một ngày nào đó, hoặc không. Dù thế nào, hai tuần qua đều dạy cùng một bài học mà
source.unsplash.com đã dạy năm 2024: một tính năng ảnh phụ thuộc vào thiện chí của một thư viện duy nhất
là một điểm lỗi duy nhất. Pexafy biến nó thành một key trên
9 thư viện — gồm cả Pexels — với kiểu tìm kiếm hiểu bạn muốn nói gì.
Lấy key miễn phí của bạn và lần tìm kiếm đầu tiên sẽ chạy trong năm
phút tới.
Tài liệu tham khảo & chú thích
1 Các bản lưu của Wayback Machine cho https://www.pexels.com/api/:
bản lưu ngày 28 tháng 9 năm 2026, 17:42 UTC không có thông báo tạm dừng; bản lưu ngày
4 tháng 10 năm 2026, 03:44 UTC có câu “New API key issuance is currently
paused.” (ba lần trong mã nguồn trang). Câu này cũng có trong bản lưu ngày 9 tháng 10 và trên
trang trực tiếp ngày 14 tháng 10.
2 Các mốc ngày của trung tâm trợ giúp lấy từ Help Center API công khai của
help.pexels.com (/api/v2/help_center/en-us/articles/<id>.json), trường
edited_at — lần thay đổi nội dung bài gần nhất. “How do I get an API key?”
(900004904026): 2026-09-30 19:14:37 UTC; siêu dữ liệu của bài được động đến thêm một lần vào ngày 14 tháng 10
trong khi nội dung giữ nguyên. “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, tất cả vào ngày 30 tháng 9.
3 API tìm kiếm của GitHub (issue và pull request), ngày 14 tháng 10 năm 2026, tìm thông báo này và các cách diễn đạt gần giống, tạo từ ngày 28 tháng 9. Chúng tôi đã đọc từng kết quả; 15 trường hợp sau đây nêu việc tạm dừng làm lý do thay đổi: 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. Chín trường hợp chuyển sang Pixabay (ShortForge thêm Pexafy bên cạnh), một chuyển sang Wikimedia Commons, năm gác lại vấn đề hoặc ghi nhận khoảng trống. Chỉ tính các repository công khai, nên mọi con số đều là mức tối thiểu.
Nguồn gốc, đọc ngày 14 tháng 10 năm 2026: Pexels API · Tài liệu API Pexels · “How do I get an API key?” · “How do I get unlimited requests?” · “Do I have to pay for higher limits?” · “How do I change my API key?” · Tài liệu API Pixabay · Tài liệu API Unsplash · Openverse API · Tài liệu API và MCP của Pexafy. Các gói của Pexafy được đọc trực tiếp từ danh mục bảng giá.
Câu hỏi thường gặp
Pexels có còn cấp API key mới không?
Các API key Pexels hiện có còn dùng được không?
[email protected] — vì vậy hãy giữ key tránh xa code front end và các repository công khai.Khi nào Pexels sẽ cấp API key trở lại?
Giải pháp thay thế tốt nhất cho Pexels API là gì?
Tôi có còn dùng được ảnh Pexels mà không có API key Pexels không?
Làm sao chuyển từ Pexels API sang Pexafy?
https://api.pexafy.com/api/v1/search/photos), header xác thực (X-Api-Key thay cho Authorization) và tên các trường — photos[] thành data[], src.large thành urls.regular, photographer thành photographer_full_name. Bài viết có bảng đối chiếu từng trường và một adapter nhỏ trả kết quả theo dạng Pexels, nên phần code còn lại của bạn không phải đổi.