Freepik + Claude Code: gerador de imagens com IA gratuito para WordPress

Em resumo: estava farto de perder tempo à procura de ilustrações para os artigos do blogue. Criei um plugin que gera imagens de destaque com um clique, dentro do WordPress. A Freepik dá 5 $ de crédito no registo — o suficiente para 100 a 250 imagens gratuitas.

O problema: as ilustrações comem-lhe o tempo

Quem tem um blogue conhece esta dor: escreve-se o artigo, revê-se, formata-se — e depois gastam-se mais 30 minutos à procura da imagem certa.

As opções que tinha antes:

• Bancos de imagens — iguais em todos os websites, aborrecidas
• Canva — bom, mas com passos a mais: abrir, desenhar, exportar, carregar
• DALL-E / Midjourney — ótima qualidade, mas um fluxo de trabalho pouco prático: gerar à parte, descarregar, carregar no WordPress
• Design manual — os melhores resultados, mas irrealista para todos os artigos

Queria uma coisa simples: clicar num botão no WordPress → a imagem é gerada e definida como imagem de destaque.

A solução: plugin à medida + API da Freepik

Porquê a Freepik:

1. 6 modelos de qualidade — do HyperFlux (ultrarrápido) ao Flux 2 Pro (qualidade premium)
2. Escolha do formato de saída — WebP, AVIF, JPEG, PNG
3. API simples — documentação clara, endpoints lógicos
4. 5 $ de crédito gratuito — a Freepik dá 5 $ no registo, o suficiente para 100 a 250 gerações
5. Preços justos — a partir de ~0,02 $ por imagem

Construir com o Claude Code

Fiz o plugin inteiro numa noite com o Claude Code. O processo:

1. Descrevi o que queria: «plugin para WordPress, metabox no editor, botão Generate, chamada à API da Freepik, guardar como imagem de destaque»
2. O Claude gerou a estrutura base
3. Algumas iterações para afinar: página de definições, seleção de modelo, estilos por categoria
4. Testes e correções

Tempo total: ~4 horas da ideia ao plugin a funcionar.

O que o plugin faz

🎨 Seleção do modelo de IA

O plugin suporta 6 modelos, para qualquer caso de utilização e orçamento:

As minhas escolhas: Mystic para ilustrações do blogue, HyperFlux quando preciso de algo rápido.

🖼️ Formatos de saída

Escolha o formato de imagem que melhor se ajusta às suas necessidades:

Recomendação: o WebP oferece o melhor equilíbrio entre qualidade e tamanho do ficheiro.

📐 Proporções da imagem

• 1:1 — redes sociais
• 4:3 — clássico
• 2:1 — cabeçalhos do blogue (recomendado)
• 16:9 — miniaturas de vídeo
• 9:16 — stories

🎯 Prompts inteligentes

O plugin constrói automaticamente os prompts a partir de:

• Título do artigo
• Categoria
• Excerto (primeiros 100 caracteres)
• Estilo configurado para a categoria

Exemplo de prompt de sistema:

Create a professional blog header image for an article titled "{title}". 
Style: {style_description}. 
Include elements: {elements}. 
Mood: {mood}. 
Category: {category}.

🏷️ Estilos por categoria

Configure estilos visuais próprios para cada categoria do blogue:

Category: "taxes"
Colors: "deep blue, gold accents, corporate feel"
Elements: "documents, calculator, charts"
Mood: "professional, trustworthy"

A partir de agora, todos os artigos da categoria «Taxes» têm um estilo visual coerente.

⚡ Geração automática

Opcional: o plugin pode gerar automaticamente uma imagem quando um artigo é publicado sem imagem de destaque definida.

Como fica

No editor do WordPress aparece uma metabox chamada «AI Image Generator»:

1. Veja uma pré-visualização do estilo com base na categoria do artigo
2. Clique em «Generate Image»
3. Aguarde 10 a 30 segundos
4. A imagem é definida automaticamente como imagem de destaque

Não gostou do resultado? O botão «Regenerate» cria uma nova variação.

Resultados

Alguns exemplos do trabalho do plugin num website de finanças

1 / 7

aparece no editor do WordPress, chamada «AI Image Generator»:

1. Veja uma pré-visualização do estilo com base na categoria do artigo
2. Clique em «Generate Image»
3. Aguarde 10 a 30 segundos
4. A imagem é definida automaticamente como imagem de destaque

Não gostou do resultado? O botão «Regenerate» cria uma nova variação.

Instalação e configuração

Passo 1: obter a chave de API da Freepik

1. Registe-se em freepik.com/api
2. Bónus: a Freepik credita 5 $ no registo
3. Copie a sua chave de API do painel

Passo 2: instalar o plugin

# Option 1: Clone from GitHub
cd wp-content/plugins/
git clone https://github.com/nesmachny/freepik-featured-image-generator.git

# Option 2: Download ZIP and upload via WordPress admin

Passo 3: configurar

1. Ative o plugin no WordPress
2. Vá a Definições → AI Image Generator
3. Cole a sua chave de API
4. Escolha o modelo predefinido
5. Configure os estilos por categoria (opcional)

As contas: quanto custa?

Saldo inicial: 5 $ (gratuitos no registo)

Custo por geração (aproximado):

• HyperFlux: ~0,02 $ (o mais barato)
• Flux Dev: ~0,03 $
• Mystic: ~0,04 $
• Flux 2 Turbo: ~0,05 $
• Flux 2 Pro: ~0,06 $
• Flux Pro 1.1: ~0,08 $

Com 5 $ consegue:

• ~250 imagens com o HyperFlux
• ~160 imagens com o Flux Dev
• ~100 imagens com o Mystic
• ~60 imagens com o Flux Pro 1.1

Num blogue pequeno (2 a 4 artigos por semana), os 5 $ gratuitos duram 6 a 12 meses. Depois disso — cêntimos por artigo.

REST API para automatização

O plugin disponibiliza uma REST API para integrações:

# Generate image for a post
POST /wp-json/aifig/v1/generate/{post_id}

# Custom prompt
POST /wp-json/aifig/v1/custom
{
  "prompt": "Futuristic cityscape with flying cars",
  "post_id": 123
}

Ligue-o ao n8n, ao Zapier ou aos seus próprios scripts.

Dicas para melhores resultados

Funciona bem:

• Conceitos abstratos
• Ilustrações e flat design (modelo Mystic)
• Paisagens e arquitetura
• Imagens de tecnologia

Funciona menos bem:

• Texto nas imagens (sai muitas vezes ilegível)
• Rostos de pessoas concretas
• Diagramas muito detalhados

Dica avançada: antitexto

Na versão mais recente (v1.1.1) acrescentei aos prompts, de forma automática, a instrução “no text, no letters, no words” — os resultados melhoraram de forma significativa.

Resumo

Problema: gastar mais de 30 minutos à procura de ilustrações para cada artigo

Solução: plugin para WordPress + API da Freepik + Claude Code

Resultado:

• Geração em 10 a 30 segundos
• 6 modelos de IA + 4 formatos de saída (WebP/AVIF/JPEG/PNG)
• Estilo coerente por categoria
• 5 $ gratuitos para começar (100 a 250 imagens)
• Controlo total nas definições

Ligações

• GitHub: github.com/nesmachny/freepik-featured-image-generator
• Freepik API: freepik.com/api (5 $ de crédito gratuito no registo)
• Claude Code: claude.ai

Relacionado: além das imagens, também uso o WordPress como backend de RAG para criar uma base de conhecimento de IA — o mesmo CMS, outro fluxo de trabalho com IA.

Usa IA para gerar imagens? Que ferramentas funcionam melhor no seu caso? Deixe um comentário ou escreva-me no Telegram.