Pexels 已暂停发放新的 API 密钥,该改用什么?

“New API key issuance is currently paused.”(目前暂停发放新的 API 密钥。)Pexels 改了什么、何时改的,哪些项目已经在绕开它改写代码,以及如何用五分钟切换到一把同时搜索 Pexels、Unsplash、Pixabay 等图库的密钥。

一位开发者一只手抵着额头,盯着一台贴满编程贴纸的笔记本电脑,独自坐在空荡荡的咖啡馆卡座里。
图片来自 Tim Gouw on Unsplash

你打开 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 文档: 它仍在许诺一把会“立即收到”的密钥——而这恰恰是新用户再也拿不到的东西。

这次暂停会影响哪些人

最先感受到冲击的有四类人:

  1. 所有刚起步的新项目。 业余项目、黑客松作品、课程作业、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 密钥)。
  2. 需要多一把密钥的团队。 Pexels 每个账号只分配一把密钥,而且你无法自行更换。新增一个客户、 给生产环境单独配一把密钥、给队友开一个沙盒:过去每一种情况都意味着新开一个账号、再领一把新密钥。 这条路现在被堵死了。
  3. 正在增长的产品。 在上调被暂停的情况下,一把密钥的上限就是每小时 200 次请求、每月 20,000 次。 按每天 1,000 次搜索计算,到第 20 天额度就用完了——而眼下没有任何一张表单能让你买到更多。
  4. 自动化流程与 AI 智能体。 短视频生成器、自动写博客的流水线,以及会“配一张图库照片”的智能体, 每次运行都要调用一次图片 API。下文提到的好几个项目正是这类工具:一旦配图这一步拿不到密钥, 整条流水线就会卡住。

公开可见的两周:接连不断的改写

我们在 GitHub 的公开 issue 和 PR 中搜索了这则提示及其各种改写说法。10 月 1 日至 13 日,有 15 个把 Pexels 的这次暂停写成了改动的理由3。它们改用了什么,很有启发:

项目的做法数量他们自己的说法
改用 Pixabay9“Swap meal-photo lookup from Pexels to Pixabay — Pexels has paused new API keys”(把菜品照片的查找从 Pexels 换成 Pixabay——Pexels 已暂停发放新的 API 密钥)
转向 Wikimedia Commons1“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 替换的是整套集成工作。具体来说是这样:

  1. 密钥今天就能用。 用 Google、GitHub 或邮箱注册,在控制台里创建一把密钥,第一次请求就能跑通。
  2. Pexels 图库保留,其他图库一并到手。 Pexafy 把数百万张 Pexels 照片,与 Unsplash、Pixabay 以及其余共 9 个图库的内容放进同一个索引。一次查询就返回最匹配的结果, 不论它们来自哪里,并且已去重,每条结果都带有来源、摄影师和指向原始页面的链接。只想用某一个图库? 用 source 参数按服务商过滤即可。
  3. 能读懂需求的搜索结果。 关键词类 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 关键词搜索。
  4. 不论哪个图库,都是同一套结构。 每条结果都自带现成的署名文案 (attribution.html 和 attribution.plain), 所以为摄影师和图库署名只需要一行代码。
  5. 增长有空间,价格是公开的。 Pexels 刚刚暂停的那样东西——更多的请求量——在这里是一张定价表, 而不是一封邮件。就在下面。
  6. 为 AI 智能体准备好了。 支持以图搜图——上传一张照片,就能从所有图库里找到相似的图片—— 还提供托管的 MCP 服务器,让 Claude、ChatGPT、Cursor、VS Code 等智能体自己搜索照片并署名: 这正是上文那些被卡住的项目里好几个在做的事。各个客户端的配置方法见我们的 MCP 页面, 背后的思路见面向 AI 智能体的图片搜索基础设施。
套餐每月费用每月请求数每小时请求数
Pexels,默认密钥 上调已暂停$020,000200
Pexafy Free$05,0001,200
Pexafy Starter$525,0001,800
Pexafy Pro$19250,0003,600
Pexafy Team$591,000,00012,000
Pexafy Business$992,000,00018,000
Pexafy Enterprise$2495,000,00030,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"

接下来重命名你读取的那些字段。你用到的每一项都有直接对应的字段:

PexelsPexafy说明
Authorization: <key>X-Api-Key: <key>仅请求头名称不同
queryq最多 500 个字符;整句话效果最好
orientation, colororientation, color_name 或 color_hexorientation 的取值相同
locale—无需此参数:任何语言,同一个索引
page, next_pagecursor, pagination.next_cursor游标分页;per_page 最大 100
photos[]data[]
idphoto_id是字符串,不是整数
src.original · large2x · large · medium · smallurls.full · large · regular · small · thumb最接近的尺寸,由大到小
urlsource_image_url该照片在其所属图库中的页面
photographer, photographer_urlphotographer_full_name, photographer_url
avg_colorcolor_hex另有一个带名称的 color_name
altalt_description
—source, license_type, attribution新增:来源、许可、现成的署名文案

3 · 或者:让你原有的 Pexels 格式代码原封不动

如果你的前端已经在读 photos[].src.large,那就别动它。把下面这个适配器放到你的服务器上: 它调用 Pexafy,返回 Pexels 的数据结构,外加两个 Pexels 从来没提供过的字段。

pexels-compat.mjs —— 以 Pexels 的数据结构返回 Pexafy 的结果(Node 18+)
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 密钥留作备份。
overflow.py —— Pexels 返回 429 时,搜索依然有结果
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 个搁置了问题或在文档中注明了缺口。只统计公开仓库,因此所有数字都只是下限。

常见问题

Pexels 还在发放新的 API 密钥吗?
没有。自 2026 年 9 月底起,Pexels 的 API 页面及其帮助中心文章 How do I get an API key? 都以同一句话开头:“New API key issuance is currently paused.”(目前暂停发放新的 API 密钥。)Wayback Machine 在 9 月 28 日对 API 页面的存档里没有这则提示,10 月 4 日的存档里已经出现;帮助中心的文字最后一次编辑是在 9 月 30 日。Pexels 没有给出任何原因,也没有给出重新开放的日期。
已有的 Pexels API 密钥还能用吗?
Pexels 没有宣布对已发放的密钥做任何改动。变化的是上限:“API rate limit increases are currently paused”(目前暂停提高 API 速率限制),因此所有密钥都停留在默认的每小时 200 次、每月 20,000 次请求。持有者同样无法自行更换密钥——更换或注销都要通过 [email protected]——所以请把它挡在前端代码和公开仓库之外。
Pexels 什么时候会恢复发放 API 密钥?
Pexels 没有说。API 页面和帮助中心都没有给出原因或日期,而且这次暂停同样涵盖速率限制的上调。如果某个项目依赖于拿到 Pexels 密钥,请按“短期内不会恢复”来规划——值得盯着的页面是帮助中心的文章 How do I get an API key?。
Pexels API 最好的替代方案是什么?
如果你今天就需要一把密钥,Pexafy 是最直接的替代:两分钟就能拿到密钥,一次请求即可搜索来自 Pexels、Unsplash、Pixabay 等图库的数百万张免费照片,按含义而不是按标签排序,每条结果都附带署名信息。Pixabay 和 Unsplash 也提供单一图库的 API,各有各的条款。
没有 Pexels API 密钥,还能使用 Pexels 的照片吗?
可以。暂停的是 API 密钥,而不是照片:照片依然可以按 Pexels 许可免费使用。你可以到 pexels.com 手动下载,也可以通过 Pexafy 以编程方式搜索——Pexafy 与其他图库一起索引了数百万张 Pexels 照片,并在返回每张照片时附上摄影师、指向其 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 数据结构的小适配器,所以其余代码都不用改。
Pexafy 与 Pexels 有关联吗?
没有。Pexafy 是一个架在免费授权图库之上的独立搜索引擎和 API,Pexels 只是其中之一。每张照片都沿用其所属图库的许可,每条结果都链接回其原始页面和摄影师。

不必再苦苦寻找关键词。描述你想要的内容即可。

按含义搜索 9M+ 张免费图片 — 支持任何语言,响应不到 100 毫秒。