Documentação

Tudo o que você precisa saber para instalar, configurar e usar o Alt Text IA — do primeiro ajuste até a geração em massa.

1. Instalação

  1. No seu painel WordPress, vá em Plugins > Adicionar novo.
  2. Procure por "Alt Text IA".
  3. Clique em Instalar e depois em Ativar.

Um novo menu Configurações > Alt Text IA aparecerá no seu painel.

2. Obter uma chave de API (plano gratuito)

No modo gratuito, você usa sua própria chave de API do provedor de IA escolhido. É gratuita de obter, e a maioria oferece uma cota gratuita suficiente para testar.

Opção recomendada: Google Gemini (grátis, sem cartão)

  1. Acesse aistudio.google.com/apikey
  2. Entre com uma conta Google
  3. Clique em "Create API key"
  4. Copie a chave gerada

Alternativa: OpenAI

  1. Crie uma conta em platform.openai.com
  2. Vá em API Keys, clique em "Create new secret key"
  3. Um cartão de crédito pode ser solicitado dependendo da sua conta (cobrança por uso, poucos centavos por geração)

Alternativa: Anthropic Claude

  1. Crie uma conta em console.anthropic.com
  2. Vá em API Keys, crie uma nova chave

3. Configuração do plugin

  1. Vá em Configurações > Alt Text IA
  2. Escolha seu provedor de IA na lista suspensa
  3. Cole sua chave de API no campo correspondente
  4. Indique o idioma de geração desejado (ex.: pt_BR para português)
  5. Verifique se "Gerar automaticamente..." está marcado
  6. Clique em Salvar
O idioma de geração não é detectado automaticamente a partir do seu conteúdo: é você quem o define. Se os textos vierem no idioma errado, verifique primeiro este campo.

4. Como funciona

Geração automática: a cada novo envio de imagem para sua biblioteca de mídia, o Alt Text IA gera um texto alternativo caso a imagem ainda não tenha um. Uma imagem que já possui texto alternativo nunca é modificada.

Análise da biblioteca: o botão "Analisar minha biblioteca" (nas configurações) verifica todas as suas imagens existentes e mostra quantas não têm texto alternativo — disponível tanto no gratuito quanto no Pro.

Geração em massa (recurso Pro): processa automaticamente todas as imagens detectadas pela análise, sem precisar modificá-las uma a uma.

5. Limites do plano gratuito

RecursoGrátisPro
Geração automática no envio10 / mêsIlimitada
Chave de APISua própriaIncluída
Geração em massa (existente)—✓

A cota gratuita é reiniciada automaticamente no dia 1º de cada mês.

6. Solução de problemas

SintomaCausa provável
Texto alternativo continua vazio após o envioChave de API ausente ou inválida, cota mensal atingida, ou caixa "Geração automática" desmarcada
O texto vem no idioma erradoCorrija o campo "Idioma de geração" nas configurações
Nada acontece em uma imagem já existenteNormal: a geração automática só se aplica a novos envios. Use "Analisar minha biblioteca" e depois faça upgrade para Pro para processar o existente em massa
Erro mencionando um "modelo" de IAO provedor escolhido mudou a disponibilidade de um modelo; o plugin tenta automaticamente outro modelo disponível na próxima vez
Se o problema persistir após verificar esses pontos, verifique a cota e a validade da sua chave diretamente no site do provedor (OpenAI, Google AI Studio ou Anthropic Console) — essa é a causa mais comum.

7. Fazer upgrade para Pro

Em Configurações > Alt Text IA, clique em "Fazer upgrade para Pro para desbloquear a geração em massa". O pagamento e a gestão de licenças são feitos com segurança pela Freemius; nenhuma chave de API precisa ser configurada no modo Pro.