Pexels ha puesto en pausa las nuevas claves de API: qué usar en su lugar
«New API key issuance is currently paused.» Qué cambió Pexels y cuándo, los proyectos que ya reescriben su código y el cambio en cinco minutos a una sola clave que busca en Pexels, Unsplash, Pixabay y más.
Abres la página de la API de Pexels para conseguir una clave y la página responde antes de que preguntes: «New API key issuance is currently paused.» Ni formulario que rellenar, ni lista de espera a la que apuntarse, ni una fecha en la que apoyar un plan. Para una API que innumerables tutoriales presentan como una clave gratuita que se consigue en treinta segundos, esa sola frase cierra la puerta de entrada a todo proyecto nuevo, a todo compañero nuevo y a todo agente de IA que estaba a punto de conectarse a ella.
Este artículo fija qué cambió Pexels y cuándo, a partir de fuentes primarias; muestra a quién afecta ya, con las pull requests públicas como prueba; y defiende dónde aterrizar, con una migración que puedes copiar en cinco minutos. ¿Con prisa? Salta directamente al cambio.
Qué cambió Pexels y cuándo
No hemos encontrado ninguna entrada de anuncio. Los avisos simplemente aparecieron en la parte superior de páginas que ya existían. Leídos uno junto a otro, dicen esto:
| Página | Qué dice ahora | Última modificación del texto |
|---|---|---|
pexels.com/api |
«New API key issuance is currently paused.» | Entre el 28 de septiembre y el 4 de octubre de 20261 |
| Centro de ayuda · How do I get an API key? | «New API key issuance is currently paused.» — justo encima de las instrucciones antiguas, que siguen terminando con «You'll receive your API key immediately.» (recibirás tu clave de API de inmediato). | 30 de septiembre de 2026, 19:14 UTC2 |
| Centro de ayuda · How do I get unlimited requests? | «API rate limit increases are currently paused.» Límites por defecto: 200 peticiones/hora y 20.000/mes. | 30 de septiembre de 2026, 19:15 UTC |
| Centro de ayuda · Do I have to pay for higher limits? | «API rate limit increases are currently paused.» | 30 de septiembre de 2026, 19:13 UTC |
| Centro de ayuda · How do I change my API key? | «API keys can't be changed by you» (tú no puedes cambiar las claves de API) — para pedir una clave nueva o cancelar la anterior, hay que escribir a [email protected]. |
30 de septiembre de 2026, 19:04 UTC |
| Documentación de la API | Sigue diciendo que cualquiera con una cuenta puede solicitar una clave «which you will receive instantly» (que recibirás al instante). | Sin actualizar |
Consultado el 14 de octubre de 2026. Cómo se estableció cada fecha figura en las notas al pie.
Las marcas de tiempo cuadran. Los cuatro artículos del centro de ayuda se editaron entre las 19:04 y las 19:15 UTC del 30 de septiembre; el aviso no aparece en la captura que la Wayback Machine hizo de la página de la API el 28 de septiembre y sí en la del 4 de octubre; y el primer issue público de GitHub que lo cita se abrió el 1 de octubre. Pexels no ha dado ningún motivo ni calendario, y dos semanas después los avisos siguen ahí. Solo la documentación de la API no se ha puesto al día: sigue describiendo una clave «which you will receive instantly», justo lo que un usuario nuevo ya no puede conseguir.
A quién afecta
Cuatro grupos lo notan primero:
-
Todo el que empieza algo nuevo. El proyecto personal, el trabajo para el hackathon, el ejercicio del
curso, el MVP. Todos los tutoriales de Pexels escritos antes de octubre arrancan con el único paso que ya no
funciona, y lo mismo ocurre con la configuración de cualquier herramienta de código abierto que pida una
PEXELS_API_KEY. El 1 de octubre, alguien que intentaba ejecutar un proyecto de código abierto de automatización de YouTube abrió un issue cuyo título es, sin más, el muro con el que se topó: «Request API Access New API key issuance is currently paused. in Pexels» (solicitar acceso a la API; la emisión de nuevas claves de API está actualmente en pausa; en Pexels). - Equipos que necesitaban una clave más. Pexels asigna una clave por cuenta y no puedes cambiarla tú mismo. Un cliente nuevo, una clave aparte para producción, el entorno de pruebas de un compañero: cada caso exigía antes una cuenta nueva y una clave nueva. Ese camino está cerrado.
- Productos que crecen. Con los aumentos en pausa, una clave queda limitada a 200 peticiones por hora y 20.000 al mes. Con 1.000 búsquedas al día, el mes se agota el día 20, y ahora mismo no hay ningún formulario que te dé más.
- Automatizaciones y agentes de IA. Los generadores de vídeos cortos, los pipelines de blogs automáticos y los agentes que «añaden una foto de stock» llaman a una API de fotos en cada ejecución. Varios de los proyectos que vienen a continuación son justo eso: herramientas cuyo pipeline entero se detiene cuando el paso de la foto no consigue una clave.
Dos semanas de reescrituras, a la vista de todos
Buscamos en los issues y pull requests públicos de GitHub el aviso y sus paráfrasis. Entre el 1 y el 13 de octubre, 15 de ellos citan la pausa de Pexels como motivo de un cambio3. Lo que hicieron en su lugar es revelador:
| Lo que hizo el proyecto | Cantidad | En sus palabras |
|---|---|---|
| Incorporó Pixabay | 9 | «Swap meal-photo lookup from Pexels to Pixabay — Pexels has paused new API keys» (cambiar la búsqueda de fotos de comidas de Pexels a Pixabay — Pexels ha puesto en pausa las nuevas claves de API) |
| Pasó a Wikimedia Commons | 1 | «Pexels was the original plan, but Pexels has paused new API keys.» (Pexels era el plan original, pero Pexels ha puesto en pausa las nuevas claves de API.) |
| Lo aparcó o documentó la carencia | 5 | «PEXELS_KEY waits until they reopen» (PEXELS_KEY espera hasta que reabran) |
Pixabay es el reflejo evidente: su clave aparece en cuanto inicias sesión y permite 100 peticiones por minuto, 6.000 por hora. Pero cambiar de clave nunca es solo cambiar de clave. Las condiciones de la API de Pixabay prohíben el hotlinking permanente — «please download them to your server first» (descárgalas primero en tu servidor) — y exigen cachear las respuestas de la API durante 24 horas, de modo que las pull requests que hacen el cambio acaban añadiendo almacenamiento, una caché y un paso de alojamiento propio. Una de ellas lo dice sin rodeos: «Pixabay photos are downloaded and re-hosted.» (las fotos de Pixabay se descargan y se vuelven a alojar). Además, cada uno de estos cambios sustituye un catálogo por otro: otros fotógrafos, otro estilo y ninguno de los resultados de búsqueda en torno a los que se diseñó el producto. (Un proyecto tomó otro camino y añadió Pexafy junto a Pixabay en su cadena de proveedores.)
Nada de esto es nuevo. Cuando Unsplash apagó source.unsplash.com en 2024, las correcciones seguían llegando
dos años después; lo medimos en nuestra
autopsia de source.unsplash.com.
Las APIs de fotos gratuitas cambian sus condiciones según su propio calendario. La pregunta útil no es en qué biblioteca
apostar ahora, sino cuánto de tu producto debería depender de una sola de ellas.
Tus opciones hoy
| Opción | ¿Clave hoy? | Plan gratuito | ¿Fotos de Pexels? | Qué te exige |
|---|---|---|---|---|
| Esperar a Pexels | No en pausa, sin fecha | — | Sí, con el tiempo | Una hoja de ruta que depende de una fecha que nadie ha publicado |
| API de Pixabay | Sí, tras iniciar sesión | 6.000 peticiones/hora | No | Descargar y volver a alojar las imágenes, cachear las respuestas 24 h, mostrar a los usuarios de dónde vienen las imágenes |
| API de Unsplash | Sí, en modo demo | 50 peticiones/hora en modo demo, 1.000 tras la aprobación | No | Seguir sus directrices de API (hotlinking, atribución, registro de descargas) |
| Openverse | No hace falta | Anónimo, con limitaciones | No | Licencias Creative Commons, cada una con sus propias condiciones de atribución |
| Pexafy | Sí al registrarte, sin tarjeta | 5,000 peticiones/mes, hasta 1,200/hora | Sí junto con Unsplash, Pixabay y más | Una clave; cada foto conserva la licencia de su fuente |
Límites convertidos a peticiones por hora (Pixabay documenta 100 por minuto). Reglas de Pixabay y Unsplash leídas en su documentación de la API el 14 de octubre de 2026; Openverse, tal como se comprobó el 11 de octubre. Para ver las cuotas convertidas a la misma unidad y la tabla completa de diez criterios, consulta nuestra comparativa de APIs de fotos de stock gratuitas.
Por qué Pexafy es el cambio que conviene hacer
Cada una de las otras filas de esa tabla sustituye una biblioteca por otra biblioteca. Pexafy sustituye la integración. Esto es lo que significa en la práctica:
- Tu clave funciona hoy. Regístrate con Google, GitHub o una dirección de correo, crea una clave en el panel y tu primera petición pasa.
-
Conservas el catálogo de Pexels y ganas los demás. Pexafy indexa millones de fotos de
Pexels junto a las de Unsplash, Pixabay y el resto de sus 9 bibliotecas,
en un único índice. Una consulta devuelve las mejores coincidencias vengan de donde vengan, sin duplicados, cada una
con su fuente, su fotógrafo y un enlace a su página original. ¿Solo quieres una biblioteca? El
parámetro
sourcefiltra por proveedor. - Resultados que entienden lo que pides. Las APIs de palabras clave comparan tus palabras con etiquetas, así que cada palabra extra deja menos resultados. Pexafy ordena por significado: describe la escena con una frase completa — hasta 500 caracteres, en más de 100 idiomas — y el detalle afina los resultados en lugar de vaciarlos. La foto que ves en lo alto de esta página es el primer resultado para una frase justo de ese tipo (aquí en inglés, porque es con esa formulación exacta como queda la primera): a stressed programmer with a hand on the forehead, staring at a laptop covered in php, git and node stickers. La mecánica se explica en nuestro artículo búsqueda semántica de imágenes frente a palabras clave.
-
Un único esquema, sea cual sea la biblioteca.
Cada resultado llega con una línea de crédito ya preparada (
attribution.htmlyattribution.plain), así que dar crédito al fotógrafo y a la biblioteca es una línea de código. - Margen para crecer, a un precio publicado. Lo que Pexels acaba de poner en pausa — más peticiones — aquí es una tabla de precios, no un correo. Está justo debajo.
- Listo para agentes de IA. Búsqueda por imagen — envía una foto y recibe parecidas de todas las bibliotecas — y un servidor MCP alojado que permite a Claude, ChatGPT, Cursor, VS Code y otros agentes buscar y acreditar fotos por sí solos: justo el trabajo que hacían varios de los proyectos atascados que vimos arriba. La configuración de cada cliente está en nuestra página de MCP, y el razonamiento detrás, en nuestro artículo sobre infraestructura de búsqueda de imágenes para agentes de IA.
| Plan | Al mes | Peticiones / mes | Peticiones / hora |
|---|---|---|---|
| Pexels, clave por defecto aumentos en pausa | $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 |
Las filas de Pexafy se leen en directo de nuestro catálogo de planes; la facturación anual cuesta menos: consulta los precios. Pexafy aplica sus límites por minuto, así que la cifra por hora es ese límite durante sesenta minutos (Free: 20 por minuto, hasta 1,200 por hora). Una petición a Pexafy busca en todas las bibliotecas a la vez.
Una cosa que conviene saber antes de cambiar: el plan gratuito es de 5,000 peticiones al mes, menos que una clave de Pexels por defecto, pero cada una de esas peticiones busca en todas las bibliotecas a la vez, y el plan Starter a $5 al mes te lleva hasta 25,000. Y cada foto conserva la licencia de la biblioteca de la que procede: Pexafy es un motor de búsqueda y una API independientes sobre esas bibliotecas, no el titular de los derechos, y no está afiliado a Pexels.
Cambia en cinco minutos
1 · Consigue una clave
Crea una cuenta gratuita y luego
crea una clave de API en tu panel. Guárdala en una
variable de entorno — PEXAFY_API_KEY — en tu servidor, nunca en código que se ejecute en el navegador.
2 · Cambia una petición
# 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"
Después, renombra los campos que lees. Todo lo que usabas tiene un equivalente directo:
| Pexels | Pexafy | Nota |
|---|---|---|
Authorization: <key> | X-Api-Key: <key> | Solo cambia el nombre del encabezado |
query | q | Hasta 500 caracteres; las frases completas funcionan mejor |
orientation, color | orientation, color_name o color_hex | Mismos valores de orientación |
locale | — | No hace falta: cualquier idioma, un solo índice |
page, next_page | cursor, pagination.next_cursor | Paginación por cursor; per_page hasta 100 |
photos[] | data[] | |
id | photo_id | Una cadena de texto, no un entero |
src.original · large2x · large · medium · small | urls.full · large · regular · small · thumb | Tamaños más cercanos, de mayor a menor |
url | source_image_url | La página de la foto en su biblioteca |
photographer, photographer_url | photographer_full_name, photographer_url | |
avg_color | color_hex | Además, un nombre de color: color_name |
alt | alt_description | |
| — | source, license_type, attribution | Novedad: de dónde viene, su licencia y una línea de crédito ya preparada |
3 · O deja intacto tu código con forma de Pexels
Si tu front end ya lee photos[].src.large, déjalo como está. Pon este adaptador en
tu servidor: llama a Pexafy y devuelve la forma de Pexels, más los dos campos que Pexels nunca te dio.
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
})),
};
}
Los filtros (orientación, color, licencia, fuente), la búsqueda por imagen y todos los campos de la respuesta están en la documentación de la API.
¿Ya tienes una clave de Pexels? Consérvala y añade una red de seguridad
-
No la pierdas. No puedes crear otra ni rotar la que tienes:
sustituirla o cancelarla pasa por
[email protected]. Si la tuya se ha subido alguna vez a un repositorio o se ha incluido en código de front end, trátalo como una urgencia: una clave filtrada que no puedes rotar es una cuota que otro puede quemar. -
Vigila el techo. Pexels informa de
X-Ratelimit-Limit,X-Ratelimit-RemainingyX-Ratelimit-Reseten las respuestas correctas, y responde429cuando te pasas. Con los aumentos en pausa, ese techo es el techo. - Añade una válvula de escape. Deja Pexels como primera llamada y que Pexafy responda cuando Pexels diga que no. O al revés: haz de Pexafy la principal — una sola llamada ya cubre Pexels y las demás bibliotecas — y deja la clave de Pexels como respaldo.
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"]]
La pausa terminará algún día, o no. En cualquier caso, las dos últimas semanas enseñan la misma lección que
source.unsplash.com enseñó en 2024: una función de fotos que depende de la buena voluntad de una sola
biblioteca es un único punto de fallo. Pexafy lo convierte en una sola clave sobre
9 bibliotecas — Pexels incluida — con una búsqueda que entiende lo que querías decir.
Consigue tu clave gratuita y tu primera búsqueda funcionará en los próximos cinco
minutos.
Referencias y notas al pie
1 Capturas de la Wayback Machine de https://www.pexels.com/api/:
la captura del 28 de septiembre de 2026, 17:42 UTC no incluye ningún aviso de pausa; la del
4 de octubre de 2026, 03:44 UTC contiene la frase «New API key issuance is currently
paused.» (tres veces en el código fuente de la página). También está en la captura del 9 de octubre y en la
página en vivo el 14 de octubre.
2 Las fechas del centro de ayuda proceden de la API pública del Help Center de
help.pexels.com (/api/v2/help_center/en-us/articles/<id>.json), campo
edited_at: el último cambio en el texto de un artículo. How do I get an API key?
(900004904026): 2026-09-30 19:14:37 UTC; sus metadatos se tocaron de nuevo el 14 de octubre
sin cambios en el texto. 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, todos el 30 de septiembre.
3 API de búsqueda de GitHub (issues y pull requests), 14 de octubre de 2026, para el aviso y sus paráfrasis, creados desde el 28 de septiembre. Se leyó cada resultado; estos 15 citan la pausa como motivo de un cambio: 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. Nueve incorporaron Pixabay (ShortForge, junto con Pexafy), uno pasó a Wikimedia Commons y cinco aparcaron la cuestión o documentaron la carencia. Solo repositorios públicos, así que todas las cifras son un mínimo.
Fuentes primarias, consultadas el 14 de octubre de 2026: API de Pexels · Documentación de la API de 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? · Documentación de la API de Pixabay · Documentación de la API de Unsplash · API de Openverse · Documentación de la API y del MCP de Pexafy. Los planes de Pexafy se leen en directo del catálogo de precios.
Preguntas frecuentes
¿Pexels sigue emitiendo claves de API nuevas?
¿Siguen funcionando las claves de API de Pexels que ya existen?
[email protected]—, así que mantenla fuera del código de front end y de los repositorios públicos.¿Cuándo volverá Pexels a emitir claves de API?
¿Cuál es la mejor alternativa a la API de Pexels?
¿Puedo seguir usando fotos de Pexels sin una clave de API de Pexels?
¿Cómo migro de la API de Pexels a Pexafy?
https://api.pexafy.com/api/v1/search/photos), el encabezado de autenticación (X-Api-Key en lugar de Authorization) y los nombres de los campos: photos[] pasa a ser data[], src.large pasa a ser urls.regular y photographer pasa a ser photographer_full_name. El artículo incluye una tabla campo por campo y un pequeño adaptador que devuelve resultados con la forma de Pexels, de modo que el resto de tu código no cambia.