O Pexels pausou as novas chaves de API. Veja o que usar no lugar

“New API key issuance is currently paused.” O que o Pexels mudou e quando, os projetos que já estão reescrevendo o código e a troca em cinco minutos para uma única chave que busca no Pexels, Unsplash, Pixabay e mais.

Compartilhar
Um desenvolvedor com a mão na testa, olhando para um notebook coberto de adesivos de programação, sozinho em uma mesa de cafeteria vazia.
Foto via Tim Gouw on Unsplash

Você abre a página da API do Pexels para pegar uma chave, e a página responde antes mesmo de você perguntar: “New API key issuance is currently paused.” Nada de formulário para preencher, nada de lista de espera para entrar, nenhuma data para usar como referência. Para uma API que incontáveis tutoriais apresentam como uma chave gratuita que se consegue em trinta segundos, essa única frase fecha a porta de entrada de todo projeto novo, de todo colega novo e de todo agente de IA que estava prestes a ser ligado a ela.

Este artigo estabelece o que o Pexels mudou e quando, a partir de fontes primárias; mostra quem já é afetado, com os pull requests públicos como prova; e defende para onde ir — com uma migração que você pode copiar em cinco minutos. Com pressa? Vá direto para a troca.

O que o Pexels mudou, e quando

Não encontramos nenhum post de anúncio. Os avisos simplesmente apareceram no topo de páginas que já existiam. Lidos lado a lado, eles dizem isto:

PáginaO que diz agoraTexto alterado pela última vez
pexels.com/api “New API key issuance is currently paused.” Entre 28 de setembro e 4 de outubro de 20261
Central de ajuda · How do I get an API key? “New API key issuance is currently paused.” — logo acima das instruções antigas, que ainda terminam com “You'll receive your API key immediately.” (você receberá sua chave de API imediatamente). 30 de setembro de 2026, 19h14 UTC2
Central de ajuda · How do I get unlimited requests? “API rate limit increases are currently paused.” Limites padrão: 200 requisições/hora e 20.000/mês. 30 de setembro de 2026, 19h15 UTC
Central de ajuda · Do I have to pay for higher limits? “API rate limit increases are currently paused.” 30 de setembro de 2026, 19h13 UTC
Central de ajuda · How do I change my API key? “API keys can't be changed by you” (você não pode alterar as chaves de API) — para pedir uma chave nova ou cancelar a antiga, é preciso escrever para [email protected]. 30 de setembro de 2026, 19h04 UTC
Documentação da API Continua dizendo que qualquer pessoa com uma conta pode solicitar uma chave “which you will receive instantly” (que você receberá instantaneamente). Não atualizada

Consultado em 14 de outubro de 2026. Como cada data foi estabelecida está nas notas de rodapé.

Os registros de data e hora batem. Os quatro artigos da central de ajuda foram editados entre 19h04 e 19h15 UTC de 30 de setembro; o aviso não aparece na captura da página da API feita pelo Wayback Machine em 28 de setembro e aparece na de 4 de outubro; e a primeira issue pública do GitHub que o cita foi aberta em 1º de outubro. O Pexels não deu motivo nem prazo, e duas semanas depois os avisos continuam no ar. Só a documentação da API não acompanhou: ela ainda descreve uma chave “which you will receive instantly” — justamente o que um novo usuário já não consegue obter.

Quem isso atinge

Quatro grupos sentem primeiro:

  1. Todo mundo que está começando algo novo. O projeto pessoal, a inscrição no hackathon, o exercício do curso, o MVP. Todo tutorial do Pexels escrito antes de outubro começa pelo único passo que não funciona mais — e o mesmo vale para a configuração de qualquer ferramenta open source que peça uma PEXELS_API_KEY. Em 1º de outubro, alguém que tentava rodar um projeto open source de automação para o YouTube abriu uma issue cujo título é só o muro em que ele bateu: “Request API Access New API key issuance is currently paused. in Pexels” (solicitar acesso à API; a emissão de novas chaves de API está atualmente pausada; no Pexels).
  2. Equipes que precisavam de mais uma chave. O Pexels atribui uma chave por conta, e você não pode trocá-la sozinho. Um cliente novo, uma chave separada para produção, o ambiente de testes de um colega: cada caso significava, antes, uma conta nova e uma chave nova. Esse caminho está fechado.
  3. Produtos em crescimento. Com os aumentos pausados, uma chave fica limitada a 200 requisições por hora e 20.000 por mês. Com 1.000 buscas por dia, o mês acaba no dia 20 — e, hoje, não existe formulário que compre mais.
  4. Automações e agentes de IA. Geradores de vídeos curtos, pipelines de blog automático e agentes que “adicionam uma foto de banco de imagens” chamam uma API de fotos a cada execução. Vários dos projetos a seguir são exatamente isso: ferramentas cujo pipeline inteiro trava quando a etapa da foto não consegue uma chave.

Duas semanas de reescritas, à vista de todos

Procuramos o aviso e suas paráfrases nas issues e nos pull requests públicos do GitHub. Entre 1 e 13 de outubro, 15 deles citam a pausa do Pexels como motivo de uma mudança3. O que fizeram no lugar é revelador:

O que o projeto fezQuantidadeNas palavras deles
Trouxe o Pixabay9“Swap meal-photo lookup from Pexels to Pixabay — Pexels has paused new API keys” (trocar a busca de fotos de refeições do Pexels para o Pixabay — o Pexels pausou as novas chaves de API)
Migrou para a Wikimedia Commons1“Pexels was the original plan, but Pexels has paused new API keys.” (o Pexels era o plano original, mas o Pexels pausou as novas chaves de API.)
Deixou de lado ou documentou a lacuna5“PEXELS_KEY waits until they reopen” (PEXELS_KEY espera até eles reabrirem)

O Pixabay é o reflexo óbvio: a chave aparece assim que você faz login, e ele permite 100 requisições por minuto — 6.000 por hora. Mas trocar de chave nunca é só trocar de chave. Os termos da API do Pixabay proíbem o hotlinking permanente — “please download them to your server first” (baixe-as primeiro para o seu servidor) — e exigem que as respostas da API sejam mantidas em cache por 24 horas; por isso os pull requests que fazem a troca acabam adicionando armazenamento, um cache e uma etapa de hospedagem própria. Um deles diz isso sem rodeios: “Pixabay photos are downloaded and re-hosted.” (as fotos do Pixabay são baixadas e hospedadas novamente). Cada uma dessas trocas também substitui um catálogo por outro — outros fotógrafos, outro visual e nenhum dos resultados de busca em torno dos quais o produto foi projetado. (Um projeto seguiu outro caminho e adicionou o Pexafy ao lado do Pixabay na sua cadeia de provedores.)

Nada disso é novo. Quando o Unsplash desligou o source.unsplash.com em 2024, as correções ainda estavam chegando dois anos depois — medimos isso no nosso post-mortem do source.unsplash.com. As APIs gratuitas de fotos mudam seus termos no calendário delas. A pergunta útil não é em qual biblioteca apostar agora, e sim quanto do seu produto deveria depender de uma só delas.

Suas opções hoje

OpçãoChave hoje?Plano gratuitoFotos do Pexels?O que exige de você
Esperar o Pexels Não pausado, sem data — Sim, um dia Um roadmap que depende de uma data que ninguém publicou
API do Pixabay Sim, após o login 6.000 requisições/hora Não Baixar e hospedar as imagens por conta própria, manter as respostas em cache por 24 h, mostrar aos usuários de onde vêm as imagens
API do Unsplash Sim, em modo demo 50 requisições/hora em modo demo, 1.000 após a aprovação Não Seguir as diretrizes da API (hotlinking, atribuição, registro de downloads)
Openverse Não é necessária Anônimo, com limitação Não Licenças Creative Commons, cada uma com seus próprios termos de atribuição
Pexafy Sim no cadastro, sem cartão 5,000 requisições/mês, até 1,200/hora Sim junto com Unsplash, Pixabay e mais Uma chave; cada foto mantém a licença da sua fonte

Limites convertidos em requisições por hora (o Pixabay documenta 100 por minuto). Regras do Pixabay e do Unsplash lidas na documentação das APIs em 14 de outubro de 2026; Openverse conforme verificado em 11 de outubro. Para as cotas convertidas na mesma unidade e a tabela completa de dez critérios, veja nossa comparação de APIs gratuitas de fotos.

Por que o Pexafy é a troca a fazer

Cada uma das outras linhas dessa tabela troca uma biblioteca por outra biblioteca. O Pexafy troca a integração. Na prática, isso significa:

  1. Sua chave funciona hoje. Cadastre-se com Google, GitHub ou um e-mail, crie uma chave no painel e sua primeira requisição passa.
  2. Você mantém o catálogo do Pexels — e ganha os outros. O Pexafy indexa milhões de fotos do Pexels ao lado de Unsplash, Pixabay e o restante das suas 9 bibliotecas, em um único índice. Uma consulta devolve as melhores correspondências, venham de onde vierem, sem duplicatas, cada uma com sua fonte, seu fotógrafo e um link para a página original. Precisa de uma biblioteca só? O parâmetro source filtra por provedor.
  3. Resultados que entendem o pedido. As APIs por palavra-chave comparam suas palavras com tags, então cada palavra a mais deixa menos resultados. O Pexafy ordena por significado: descreva a cena em uma frase completa — até 500 caracteres, em mais de 100 idiomas — e o detalhe afina os resultados em vez de esvaziá-los. A foto no topo desta página é o primeiro resultado para exatamente esse tipo de frase (aqui em inglês, porque é com essa formulação exata que ela fica em primeiro): a stressed programmer with a hand on the forehead, staring at a laptop covered in php, git and node stickers. A mecânica está explicada no nosso artigo busca semântica de imagens vs. palavras-chave.
  4. Um único schema, seja qual for a biblioteca. Cada resultado traz uma linha de crédito pronta (attribution.html e attribution.plain), então creditar o fotógrafo e a biblioteca é uma linha de código.
  5. Espaço para crescer, com preço publicado. O que o Pexels acabou de pausar — mais requisições — aqui é uma tabela de preços, não um e-mail. Ela está logo abaixo.
  6. Pronto para agentes de IA. Busca por imagem — envie uma foto, receba parecidas de todas as bibliotecas — e um servidor MCP hospedado que permite a Claude, ChatGPT, Cursor, VS Code e outros agentes buscar e creditar fotos por conta própria: exatamente o trabalho que vários dos projetos travados acima faziam. A configuração de cada cliente está na nossa página de MCP, e o raciocínio por trás dela no nosso artigo sobre infraestrutura de busca de imagens para agentes de IA.
PlanoPor mêsRequisições / mêsRequisições / hora
Pexels, chave padrão aumentos pausados$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

As linhas do Pexafy são lidas ao vivo do nosso catálogo de planos; o pagamento anual sai mais barato — veja os preços. O Pexafy aplica seus limites por minuto, então o valor por hora é esse limite ao longo de sessenta minutos (Free: 20 por minuto, até 1,200 por hora). Uma requisição ao Pexafy busca em todas as bibliotecas ao mesmo tempo.

Uma coisa a saber antes de trocar: o plano gratuito tem 5,000 requisições por mês, menos que uma chave padrão do Pexels — mas cada uma dessas requisições busca em todas as bibliotecas ao mesmo tempo, e o plano Starter a $5 por mês leva você a 25,000. E cada foto mantém a licença da biblioteca de onde vem: o Pexafy é um mecanismo de busca e uma API independentes sobre essas bibliotecas, não o detentor dos direitos, e não é afiliado ao Pexels.

Troque em cinco minutos

1 · Pegue uma chave

Crie uma conta gratuita e depois crie uma chave de API no seu painel. Guarde-a em uma variável de ambiente — PEXAFY_API_KEY — no seu servidor, nunca em código de navegador.

2 · Troque uma requisição

Antes e depois — a mesma busca
# 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"

Depois, renomeie os campos que você lê. Tudo o que você usava tem um equivalente direto:

PexelsPexafyObservação
Authorization: <key>X-Api-Key: <key>Só muda o nome do cabeçalho
queryqAté 500 caracteres; frases completas funcionam melhor
orientation, colororientation, color_name ou color_hexMesmos valores de orientação
locale—Desnecessário: qualquer idioma, um único índice
page, next_pagecursor, pagination.next_cursorPaginação por cursor; per_page até 100
photos[]data[]
idphoto_idUma string, não um inteiro
src.original · large2x · large · medium · smallurls.full · large · regular · small · thumbTamanhos mais próximos, do maior para o menor
urlsource_image_urlA página da foto na sua biblioteca
photographer, photographer_urlphotographer_full_name, photographer_url
avg_colorcolor_hexMais um nome de cor, color_name
altalt_description
—source, license_type, attributionNovo: de onde vem, a licença e uma linha de crédito pronta

3 · Ou mantenha seu código no formato Pexels, intocado

Se o seu front-end já lê photos[].src.large, deixe como está. Coloque este adaptador no seu servidor: ele chama o Pexafy e devolve o formato do Pexels, mais os dois campos que o Pexels nunca te deu.

pexels-compat.mjs — resultados do Pexafy no formato Pexels (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
    })),
  };
}

Filtros (orientação, cor, licença, fonte), busca por imagem e todos os campos da resposta estão na documentação da API.

Já tem uma chave do Pexels? Guarde-a — e monte uma rede de segurança

  • Não a perca. Você não pode criar outra, nem rotacionar a sua sozinho: trocar ou cancelar uma chave passa por [email protected]. Se a sua já foi parar em um repositório ou foi embutida em código de front-end, trate isso como urgente — uma chave vazada que você não consegue rotacionar é uma cota que outra pessoa pode queimar.
  • Fique de olho no teto. O Pexels informa X-Ratelimit-Limit, X-Ratelimit-Remaining e X-Ratelimit-Reset nas respostas bem-sucedidas, e responde 429 quando você passa do limite. Com os aumentos pausados, esse teto é o teto.
  • Adicione uma válvula de escape. Mantenha o Pexels como primeira chamada e deixe o Pexafy responder quando o Pexels disser não. Ou inverta: faça do Pexafy o principal — uma única chamada já cobre o Pexels e as outras bibliotecas — e mantenha a chave do Pexels como reserva.
overflow.py — quando o Pexels responde 429, a busca continua respondendo
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"]]

A pausa vai acabar um dia, ou não. De qualquer forma, as duas últimas semanas ensinam a mesma lição que o source.unsplash.com ensinou em 2024: um recurso de fotos que depende da boa vontade de uma única biblioteca é um ponto único de falha. O Pexafy troca essa dependência por uma só chave sobre 9 bibliotecas — Pexels incluído — com uma busca que entende o que você quis dizer. Pegue sua chave gratuita e sua primeira busca roda nos próximos cinco minutos.

Referências e notas de rodapé

1 Capturas do Wayback Machine de https://www.pexels.com/api/: a captura de 28 de setembro de 2026, 17h42 UTC, não traz nenhum aviso de pausa; a de 4 de outubro de 2026, 03h44 UTC, contém a frase “New API key issuance is currently paused.” (três vezes no código-fonte da página). Ela também está na captura de 9 de outubro e na página ao vivo em 14 de outubro.

2 As datas da central de ajuda vêm da API pública do Help Center de help.pexels.com (/api/v2/help_center/en-us/articles/<id>.json), campo edited_at — a última alteração no texto de um artigo. How do I get an API key? (900004904026): 2026-09-30 19:14:37 UTC; os metadados foram mexidos de novo em 14 de outubro com o texto inalterado. 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 em 30 de setembro.

3 API de busca do GitHub (issues e pull requests), 14 de outubro de 2026, pesquisando o aviso e suas paráfrases, em itens criados a partir de 28 de setembro. Cada resultado foi lido; estes 15 citam a pausa como motivo de uma mudança: 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. Nove trouxeram o Pixabay (o ShortForge, junto com o Pexafy), um migrou para a Wikimedia Commons e cinco deixaram a questão de lado ou documentaram a lacuna. Apenas repositórios públicos, então todos os números são um piso.

Perguntas frequentes

O Pexels ainda emite novas chaves de API?
Não. Desde o fim de setembro de 2026, a página da API do Pexels e o artigo da central de ajuda How do I get an API key? abrem com a mesma linha: “New API key issuance is currently paused.” (a emissão de novas chaves de API está atualmente pausada). O aviso não aparece na captura da página da API feita pelo Wayback Machine em 28 de setembro e aparece na de 4 de outubro, e o texto da central de ajuda foi editado pela última vez em 30 de setembro. O Pexels não dá motivo nem data de reabertura.
As chaves de API do Pexels que já existem ainda funcionam?
O Pexels não anunciou nenhuma mudança para as chaves já emitidas. O que mudou foi o teto: “API rate limit increases are currently paused” (os aumentos do limite de taxa da API estão atualmente pausados), então toda chave continua no limite padrão de 200 requisições por hora e 20.000 por mês. Os titulares também não conseguem trocar a própria chave — substituí-la ou cancelá-la passa por [email protected] —, então mantenha-a fora de código de front-end e de repositórios públicos.
Quando o Pexels vai voltar a emitir chaves de API?
O Pexels não disse. Nem a página da API nem a central de ajuda trazem motivo ou data, e a pausa vale também para os aumentos de limite. Se um projeto depende de conseguir uma chave do Pexels, planeje como se ela não fosse chegar tão cedo — o artigo da central de ajuda How do I get an API key? é a página para acompanhar.
Qual é a melhor alternativa à API do Pexels?
Se você precisa de uma chave hoje, o Pexafy é a substituição mais direta: a chave sai em dois minutos e uma única requisição busca em milhões de fotos de uso livre do Pexels, Unsplash, Pixabay e de outras bibliotecas, ordenadas por significado e não por tags, com uma linha de crédito em cada resultado. Pixabay e Unsplash também oferecem APIs de uma biblioteca só, cada uma com seus próprios termos.
Ainda posso usar fotos do Pexels sem uma chave de API do Pexels?
Sim. A pausa diz respeito às chaves de API, não às fotos: elas continuam livres para uso sob a licença do Pexels. Você pode baixá-las manualmente em pexels.com ou buscá-las via código pelo Pexafy, que indexa milhões de fotos do Pexels ao lado de outras bibliotecas e devolve cada uma com o fotógrafo, um link para a página no Pexels e uma linha de crédito pronta.
Como migro da API do Pexels para o Pexafy?
Mude três coisas: o endpoint (https://api.pexafy.com/api/v1/search/photos), o cabeçalho de autenticação (X-Api-Key em vez de Authorization) e os nomes dos campos — photos[] vira data[], src.large vira urls.regular, photographer vira photographer_full_name. O artigo traz uma tabela campo a campo e um pequeno adaptador que devolve resultados no formato do Pexels, então o resto do seu código não muda.
O Pexafy é afiliado ao Pexels?
Não. O Pexafy é um mecanismo de busca e uma API independentes sobre bibliotecas de fotos com licença livre, entre elas o Pexels. Cada foto mantém a licença da biblioteca de onde vem, e cada resultado aponta para a página original e para o fotógrafo.

Pare de caçar palavras-chave. Descreva o que você quer dizer.

Busque 9M+ imagens gratuitas por significado — em qualquer idioma, em menos de 100 ms.