Verifique nomes de imagem descritivos e com hifens
Saiba antes de publicar se o nome de uma imagem ajuda: red-running-shoes-side-view.jpg passa, enquanto untitled.webp é marcado como genérico. Cada problema aparece separado, de espaços e sublinhados a maiúsculas ou hifens repetidos, e nenhuma imagem é enviada. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Nome do arquivo
- red-running-shoes-side-view.jpg
- Nome base
- red-running-shoes-side-view
- Extensão
- jpg
Um bom nome de arquivo oferece às pessoas, equipes de conteúdo e mecanismos de busca uma pista clara antes que a imagem seja aberta. Este verificador analisa um nome em segundos, identifica padrões genéricos de câmeras e exportações, confirma a separação por hifens e relata cada problema separadamente. A verificação é determinística, privada e não exige o envio da imagem.
O que torna um nome de imagem descritivo
Um nome descritivo identifica o assunto visível ou o contexto útil do arquivo, em vez de preservar um contador de câmera ou um rótulo provisório de exportação. Por exemplo, tenis-vermelho-vista-lateral.jpg orienta quem edita, enquanto IMG_1234.jpg, screenshot-2026-01-12.png e untitled.webp não ajudam. O verificador usa uma lista conservadora de palavras genéricas e padrões numéricos conhecidos.
Ele não interpreta os pixels; portanto, não confirma se a descrição corresponde à imagem nem escolhe palavras-chave ideais. Esse limite permite aplicar uma regra determinística no formulário de upload, sempre com a mesma resposta e sem transmitir a imagem. Quando um nome genérico for apontado, substitua-o por uma frase curta que identifique de fato o assunto, a variante, o ângulo, o local ou a finalidade do recurso.
Evite excesso de palavras-chave: uma descrição natural e específica é mais útil do que uma sequência longa e repetitiva.
Por que hifens e extensões são avaliados separadamente
O teste de formato espera letras minúsculas e dígitos organizados em termos separados por um único hífen. Espaços, sublinhados, maiúsculas, pontuação, hifens iniciais ou finais e hifens repetidos causam reprovação. Uma raiz descritiva de uma palavra pode passar, pois não há termos distintos para separar.
A extensão é obrigatória porque estabelece claramente a fronteira entre a raiz e o formato do arquivo. Assim, a falta de extensão gera um erro de entrada, não um resultado SEO negativo comum. Toda solicitação válida possui raiz e extensão; depois, os indicadores mostram se a raiz é descritiva e está bem formatada.
A saída apresenta a extensão em minúsculas e inclui uma sugestão determinística quando há falha. Use essa sugestão apenas como auxílio de formatação. Se a raiz original for genérica, troque-a por palavras fundamentadas na imagem antes da publicação.
Como usar o resultado no fluxo de publicação
Execute a verificação quando um recurso entrar no seu CMS, catálogo de produtos, biblioteca digital ou repositório de site estático. Na integração contínua, você pode bloquear novos arquivos inválidos e revisar os antigos aos poucos. Somente o nome é aceito, nunca um caminho, para impedir que pastas afetem a avaliação e manter resultados consistentes entre sistemas operacionais.
Nenhuma chamada de rede é feita e nenhum byte da imagem é lido. Registre os códigos na auditoria se precisar de rastreabilidade e repita o teste após renomear para confirmar a mesma política em todos os canais.
Casos de uso
Proteja uploads no CMS
Avise a equipe editorial quando um recurso mantiver nome de câmera ou usar espaços e sublinhados.
Aplique padrões no repositório
Verifique nomes básicos durante o build e mostre códigos estáveis antes da publicação.
Organize o catálogo de mídia
Avalie nomes exportados de modo consistente antes de planejar uma renomeação controlada em lote.
Perguntas frequentes
Quanto custa a verificação?
O algoritmo não usa rede nem modelo de IA.
Por que a extensão é obrigatória?
Ela define uma fronteira inequívoca entre a raiz descritiva e o formato. A ausência é tratada como entrada inválida.
Um resultado válido garante melhor posicionamento?
Não. Ele confirma uma convenção de nome, não desempenho de busca. Relevância, contexto, texto alternativo e qualidade também importam.
Sublinhados são aceitos como separadores?
Não. Separe palavras com um único hífen. Sublinhados, espaços e hifens repetidos reprovam.
A ferramenta examina ou envia minha imagem?
Não. Ela recebe somente o nome do arquivo e executa verificações locais determinísticas.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/seo/image-filename-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"filename":"red-running-shoes-side-view.jpg"}'const res = await fetch("https://api.kit.forhosting.com/seo/image-filename-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"filename": "red-running-shoes-side-view.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/image-filename-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"filename": "red-running-shoes-side-view.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/image-filename-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"filename":"red-running-shoes-side-view.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"filename":"red-running-shoes-side-view.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/image-filename-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"filename": "red-running-shoes-side-view.jpg"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.image_filename_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Envie o nome com a extensão e receba um resultado JSON estável para formulários de CMS, fluxos de upload, listas editoriais ou scripts em lote.
Como usar o resultado no fluxo de publicação
O resultado separa descriptive de hyphen_separated, reúne ambos em valid e fornece códigos de problema estáveis. Assim, uma interface informa com precisão se é necessário reescrever um nome genérico, corrigir separadores ou fazer as duas coisas. Cada verificação automatizada pela API custa US$ 0,002.