ForHosting KIT · Imagens

Renomear imagens em lote com padrão e numeração

Transforme uma lista ordenada de nomes de imagens em uma sequência limpa e consistente antes de renomear, enviar, arquivar ou publicar os arquivos reais.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe um padrão com marcador de contador, escolha o número inicial e receba um mapeamento explícito do nome original para o novo. A ferramenta pode preservar cada extensão original, reutilizar o nome-base e preencher números para manter a ordenação natural. Ela apenas calcula nomes: nunca lê, envia, move nem altera uma imagem, portanto você pode revisar com facilidade todas as mudanças propostas antes de qualquer operação no sistema de arquivos.

Crie um padrão claro para os nomes das imagens

Uma boa renomeação em lote começa com um padrão que descreve a coleção, e não a câmera ou o celular que a criou. Use {counter} no lugar do número sequencial, como em produto-vermelho-{counter}{ext}. Use {counter:3} para definir uma largura mínima fixa e gerar 001, 002 e 003. A largura pode ter de um a vinte dígitos, e um número que já seja maior nunca é cortado. Acrescente {ext} para manter exatamente a extensão de cada arquivo de origem, inclusive maiúsculas e minúsculas, ou use {name} quando o nome-base original precisar continuar no resultado. O mesmo marcador pode aparecer várias vezes. O texto literal permanece inalterado. Como o resultado é um nome de arquivo, e não um caminho, barras normais e invertidas geradas são recusadas. Isso mantém a operação limitada à nomenclatura e impede mudanças silenciosas de diretório. Revise o mapeamento retornado antes de aplicá-lo com um gerenciador de arquivos, script, pipeline de ativos ou biblioteca de mídia.

Controle a ordem, a numeração e os nomes duplicados

A lista de entrada determina a ordem. O primeiro nome recebe o valor de start, o segundo recebe o inteiro seguinte e o processamento continua sem ordenar nem interpretar datas escondidas nos nomes. Assim, o resultado é previsível quando sua lista já representa a ordem de uma sessão, planilha, seleção ou sequência editorial. O valor inicial padrão é 1, mas 0 e outros inteiros seguros não negativos são aceitos em sistemas com numeração iniciada em zero. Todo nome gerado é verificado contra colisões. Um padrão sem contador é válido quando outros marcadores ainda produzem nomes distintos; por exemplo, {name}-aprovado{ext} normalmente continua único. Porém, se esse padrão gerar o mesmo nome para duas imagens, a solicitação falha e informa que falta um contador. Padrões que incluem contador também são verificados, pois entradas repetidas ou um padrão que descarte diferenças importantes ainda podem causar colisões em casos incomuns. Nenhum mapeamento parcial é devolvido quando há falha de validação; uma resposta bem-sucedida pode ser tratada como um plano completo de renomeação.

Use o mapeamento com segurança em um fluxo real

Esta capacidade calcula um plano de renomeação e propositalmente não toca nos arquivos. Cada resultado associa o nome original à substituição proposta, permitindo que uma pessoa ou um programa posterior examine todas as mudanças. Essa separação ajuda fotógrafos que preparam folhas de contato, equipes de comércio eletrônico que normalizam ativos, desenvolvedores que organizam dados de teste e arquivistas que criam sequências estáveis. Preserve {ext} quando um lote misturar JPEG, PNG, WebP ou extensões com letras em caixas diferentes; o marcador copia o sufixo de cada origem, em vez de impor um formato. Lembre-se de que renomear não converte os dados da imagem, portanto trocar o texto da extensão não altera o formato real. As entradas devem ser nomes de arquivos, não caminhos, e podem ter até 255 caracteres. Cada lote aceita até 10,000 itens. Para executar a mudança, consuma o mapeamento com uma ferramenta que detecte destinos existentes e faça uma renomeação em duas etapas quando nomes antigos e novos se sobrepuserem. A solicitação de API custa US$ 0,002. A mesma entrada sempre retorna o mesmo resultado, sem uploads, rede, aleatoriedade ou dependência do tempo.

Sequenciar um ensaio fotográfico

Converta nomes criados pela câmera em uma série ordenada com preenchimento, mantendo a extensão original de cada imagem.

Padronizar imagens de produtos

Crie nomes previsíveis para ativos de loja usando uma lista ordenada de ângulos e variações dos produtos.

Pré-visualizar a renomeação de um acervo

Gere e confira o mapeamento completo dos nomes antigos para os novos antes de alterar qualquer arquivo.

Quais marcadores de contador são aceitos?

Use {counter} para um número sem preenchimento ou {counter:width}, como {counter:4}, para completar a largura mínima com zeros.

Como preservar a extensão de cada imagem?

Coloque {ext} no padrão. Ele copia a última extensão, incluindo o ponto inicial e a capitalização original.

A ferramenta renomeia ou envia minhas imagens?

Não. Ela apenas devolve um mapeamento determinístico de cada nome original para o novo nome proposto.

O que acontece se dois nomes novos forem iguais?

A solicitação inteira falha. Se não houver contador no padrão, o erro orienta você especificamente a acrescentar um.

Quanto custa a solicitação de API?

Cada solicitação custa US$ 0,002, independentemente de o contador começar em zero ou usar preenchimento.

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.

POSThttps://api.kit.forhosting.com/image/batch-rename-pattern

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/image/batch-rename-pattern \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filenames":["IMG_4102.JPG","IMG_4103.JPG","IMG_4104.PNG"],"pattern":"gallery-{counter:3}{ext}"}'
{
  "filenames": [
    "IMG_4102.JPG",
    "IMG_4103.JPG",
    "IMG_4104.PNG"
  ],
  "pattern": "gallery-{counter:3}{ext}"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.batch_rename_pattern",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_items10000
max_filename_chars255
max_pattern_chars255
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →