Pexels 已暂停发放新的 API 密钥,该改用什么?
“New API key issuance is currently paused.”(目前暂停发放新的 API 密钥。)Pexels 改了什么、何时改的,哪些项目已经在绕开它改写代码,以及如何用五分钟切换到一把同时搜索 Pexels、Unsplash、Pixabay 等图库的密钥。
你打开 Pexels 的 API 页面想申请一把密钥,页面却抢在你开口之前就回答了: “New API key issuance is currently paused.” 没有表单可填,没有候补名单可排, 也没有一个可以用来排期的日期。无数教程都把这个 API 说成“三十秒就能拿到的免费密钥”, 而这一句话,把每一个新项目、每一位新队友、每一个正准备接入它的 AI 智能体,全都挡在了门外。
本文依据一手资料,查清 Pexels 究竟改了什么、是什么时候改的;用公开的 PR 说明已经有哪些人受到影响; 并给出该转向哪里的理由——附带一套五分钟就能照抄的迁移方案。赶时间?直接跳到 切换步骤。
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 日 19:04 到 19:15(UTC)之间编辑的;Wayback Machine 在 9 月 28 日对 API 页面的存档里没有这则提示,10 月 4 日的存档里已经出现;第一个引用这句话的公开 GitHub issue,则在 10 月 1 日创建。 Pexels 没有给出原因,也没有给出时间表,两周之后这些提示仍然挂在那里。唯一没跟上的是 API 文档: 它仍在许诺一把会“立即收到”的密钥——而这恰恰是新用户再也拿不到的东西。
这次暂停会影响哪些人
最先感受到冲击的有四类人:
-
所有刚起步的新项目。 业余项目、黑客松作品、课程作业、MVP。10 月之前写成的每一篇 Pexels
教程,第一步都是如今已经走不通的那一步;每一个要求配置
PEXELS_API_KEY的开源工具, 其安装步骤也是如此。10 月 1 日,有人想运行一个开源的 YouTube 自动化项目,提交了一个 issue,标题就是他撞上的那堵墙: “Request API Access New API key issuance is currently paused. in Pexels”(在 Pexels 申请 API 访问权限: 目前暂停发放新的 API 密钥)。 - 需要多一把密钥的团队。 Pexels 每个账号只分配一把密钥,而且你无法自行更换。新增一个客户、 给生产环境单独配一把密钥、给队友开一个沙盒:过去每一种情况都意味着新开一个账号、再领一把新密钥。 这条路现在被堵死了。
- 正在增长的产品。 在上调被暂停的情况下,一把密钥的上限就是每小时 200 次请求、每月 20,000 次。 按每天 1,000 次搜索计算,到第 20 天额度就用完了——而眼下没有任何一张表单能让你买到更多。
- 自动化流程与 AI 智能体。 短视频生成器、自动写博客的流水线,以及会“配一张图库照片”的智能体, 每次运行都要调用一次图片 API。下文提到的好几个项目正是这类工具:一旦配图这一步拿不到密钥, 整条流水线就会卡住。
公开可见的两周:接连不断的改写
我们在 GitHub 的公开 issue 和 PR 中搜索了这则提示及其各种改写说法。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 小时,于是这些切换的 PR 最后都多出了存储、缓存和重新托管这几个环节。其中一个直截了当地写道: “Pixabay photos are downloaded and re-hosted.”(Pixabay 的照片会被下载并重新托管。)而且每一次这样的替换, 本质上都是用一个图库换另一个图库——摄影师不同,风格不同,产品当初围绕其设计的那套搜索结果也一个都没带过来。 (有一个项目走了另一条路,在它的服务商调用链中,把 Pexafy 加到了 Pixabay 旁边。)
这一切并不新鲜。2024 年 Unsplash 关停 source.unsplash.com 时,修复工作整整两年后仍在陆续落地——我们在
source.unsplash.com
事后剖析中对此做过实测。免费图片 API 总是按自己的时间表修改条款。真正有用的问题,不是下一个该押注哪一家图库,
而是你的产品该有多大程度依赖其中任何一家。
你现在有哪些选择
| 方案 | 今天能拿到密钥吗? | 免费额度 | 有 Pexels 照片吗? | 它对你有什么要求 |
|---|---|---|---|---|
| 等 Pexels 恢复 | 不能 已暂停,没有日期 | — | 有,但要等到恢复发放 | 你的路线图得押在一个没人公布过的日期上 |
| Pixabay API | 能,登录后即可 | 每小时 6,000 次请求 | 没有 | 下载并重新托管图片,把响应缓存 24 小时,并向用户标明图片来源 |
| Unsplash API | 能,处于演示模式 | 演示模式下每小时 50 次请求,获批后 1,000 次 | 没有 | 遵守其 API 使用规范(热链接、署名、下载上报) |
| Openverse | 无需密钥 | 匿名使用,会被限流 | 没有 | 知识共享(Creative Commons)许可,每种许可有各自的署名条款 |
| Pexafy | 能 注册即得,无需信用卡 | 每月 5,000 次请求,每小时最高 1,200 次 | 有 同时还有 Unsplash、Pixabay 等 | 一把密钥;每张照片都沿用其所属图库的许可 |
速率已统一换算为每小时请求数(Pixabay 官方文档写的是每分钟 100 次)。Pixabay 与 Unsplash 的规则读取自它们 2026 年 10 月 14 日的 API 文档;Openverse 为 10 月 11 日核查的结果。想看统一单位后的配额,以及完整的十项标准对比表,请见我们的 免费图库 API 对比。
为什么该切换到 Pexafy
上表里的其他几行,都是用一个图库去替换另一个图库。Pexafy 替换的是整套集成工作。具体来说是这样:
- 密钥今天就能用。 用 Google、GitHub 或邮箱注册,在控制台里创建一把密钥,第一次请求就能跑通。
-
Pexels 图库保留,其他图库一并到手。 Pexafy 把数百万张 Pexels 照片,与 Unsplash、Pixabay
以及其余共 9 个图库的内容放进同一个索引。一次查询就返回最匹配的结果,
不论它们来自哪里,并且已去重,每条结果都带有来源、摄影师和指向原始页面的链接。只想用某一个图库?
用
source参数按服务商过滤即可。 - 能读懂需求的搜索结果。 关键词类 API 是拿你的词去匹配标签,所以每多写一个词,结果就少一些。 Pexafy 按含义排序:用一整句话描述画面——最多 500 个字符,支持 100 多种语言——细节越多,结果越精准, 而不是越来越少。本页顶部那张照片,正是这样一句话(英文原句)的第一条搜索结果: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 智能体准备好了。 支持以图搜图——上传一张照片,就能从所有图库里找到相似的图片—— 还提供托管的 MCP 服务器,让 Claude、ChatGPT、Cursor、VS Code 等智能体自己搜索照片并署名: 这正是上文那些被卡住的项目里好几个在做的事。各个客户端的配置方法见我们的 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 的限额按分钟执行,因此每小时的数字就是该限额乘以六十分钟(免费套餐:每分钟 20 次,每小时最高 1,200 次)。 Pexafy 的一次请求会同时搜索所有图库。
切换之前有一点要知道:免费套餐是每月 5,000 次请求,比 Pexels 的默认密钥要少——但每一次请求都会同时搜索所有图库,而 Starter 套餐 每月 $5,可以提升到 25,000 次。另外,每张照片都沿用其所属图库的许可: Pexafy 是架在这些图库之上的独立搜索引擎和 API,并不是权利人,也与 Pexels 没有任何关联。
五分钟完成切换
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"]]
这次暂停总有一天会结束,也可能不会。无论如何,过去这两周给出的教训,与 2024 年 source.unsplash.com
给出的如出一辙:一个依赖单一图库“好意”的图片功能,就是一个单点故障。Pexafy 把它变成了一把覆盖
9 个图库的密钥——Pexels 也在其中——搜索还能听懂你真正想要什么。
领取你的免费密钥,五分钟之内就能跑出第一次搜索。
参考资料与脚注
1 Wayback Machine 对 https://www.pexels.com/api/ 的存档:
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(issue 与 PR),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 在 Pixabay 之外还加入了 Pexafy),1 个转向 Wikimedia Commons, 5 个搁置了问题或在文档中注明了缺口。只统计公开仓库,因此所有数字都只是下限。
一手资料,读取于 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)、认证请求头(用 X-Api-Key 取代 Authorization),以及字段名——photos[] 变成 data[],src.large 变成 urls.regular,photographer 变成 photographer_full_name。文章里有逐字段的对照表,还有一个返回 Pexels 数据结构的小适配器,所以其余代码都不用改。