Traduzir HTML sem quebrar as tags
Só muda de idioma o que o visitante lê: o texto visível, o texto alternativo das imagens, as dicas de título e a meta descrição. Tags, links, classes, estilos, scripts e blocos de código voltam intactos, e a página traduzida vai ao ar sem refazer o modelo.
Rode online
Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.
Traduzir HTML pega uma página ou um trecho de código HTML e devolve o mesmo código com o texto traduzido: tags, atributos, classes e scripts ficam exatamente onde estavam. É a ferramenta para desenvolvedores e agências que precisam criar a versão em outro idioma de um site sem retrabalho de marcação.
Por que traduzir HTML como HTML
O caminho manual costuma ser copiar o texto de dentro das tags, traduzir e colar de volta, torcendo para ninguém quebrar nada no meio. Tradutores feitos para texto corrido também tropeçam no HTML, porque não distinguem uma frase de um bloco de script: o resultado traz nomes de classe traduzidos, atributos quebrados ou endereços de links alterados sem aviso, um defeito que só aparece quando um link para de funcionar no site publicado. Aqui o documento é lido primeiro como estrutura, e a tradução só toca o texto e os poucos atributos feitos para carregar idioma.
O que muda e o que fica igual
Mudam de idioma o texto visível, o texto alternativo das imagens, os títulos que aparecem ao passar o mouse e a meta descrição. Ficam exatamente como estavam os nomes das tags, as classes, os estilos embutidos, o conteúdo de script e style, os comentários, o aninhamento e os blocos pre e code, para que os exemplos de código de um tutorial não sejam traduzidos por acidente. Uma página só com estrutura, como uma quebra de linha, uma linha horizontal e uma imagem sem texto, volta idêntica e sem nenhum trecho traduzido. Isso serve para páginas de produto, artigos de central de ajuda e modelos de e-mail de cobrança.
Por que tradutor comum quebra HTML
Esta capacidade foi construída para o cenário contrário: a marcação é tratada como intocável e a tradução acontece só no conteúdo de texto. O que era um link continua o mesmo link; o que o visitante lê é o que muda de idioma.
O que entra e o que sai
Você manda o HTML — uma página completa, um componente, um template de e-mail transacional — junto com o idioma de destino. A resposta é o mesmo documento, com a mesma estrutura, pronto para publicar. Blocos de script e de estilo não são traduzidos, e URLs permanecem como estavam.
Casos de uso
E-mail transacional em três idiomas
Um SaaS envia confirmação de pedido em português, espanhol e inglês: um template só, três chamadas, e os placeholders de nome e valor continuam funcionando em todas as versões.
Loja virtual expandindo
Páginas de categoria, políticas de troca e institucionais traduzidas mantendo o tema da loja intacto — nada de refazer layout porque a tradução comeu uma div.
Central de ajuda exportada
O help center exportado em HTML é traduzido arquivo a arquivo por um script, e a versão em outro idioma entra no ar na mesma semana, com a mesma navegação.
Perguntas frequentes
O que está dentro de script ou style é traduzido?
Não. Código, estilo e URLs passam intactos; a tradução se limita ao texto que o visitante lê.
A estrutura volta idêntica mesmo? Posso comparar com diff?
A proposta é essa: mesmas tags, mesmos atributos, mesma hierarquia. Ainda assim, confira o resultado no navegador antes de publicar — o mesmo cuidado de qualquer deploy.
Vocês guardam as páginas que eu envio?
O HTML é usado para processar a tarefa e devolver o resultado; não é publicado nem reaproveitado para outra finalidade.
Aceita HTML mal formado, tipo tag sem fechar?
O motor tolera bastante coisa, mas HTML válido dá resultado mais previsível. Se a página é crítica, rode um validador antes de enviar.
O texto alternativo das imagens também é traduzido?
Sim. Além do texto visível, são traduzidos o texto alternativo (alt) das imagens, os títulos que aparecem ao passar o mouse e a meta descrição. Nomes de tags, classes e endereços dos links ficam exatamente como estavam.
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/translate/html \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"html":"<p>Hola</p>","target_lang":"en"}'const res = await fetch("https://api.kit.forhosting.com/translate/html", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"html": "<p>Hola</p>",
"target_lang": "en"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/translate/html",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"html": "<p>Hola</p>",
"target_lang": "en"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/html", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"html":"<p>Hola</p>","target_lang":"en"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"html":"<p>Hola</p>","target_lang":"en"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/html", 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
{
"html": "<p>Hola</p>",
"target_lang": "en"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "translate.html",
"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.
Limites
max_tokens | 20000 |
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. |
422 | task_failed | A tarefa falhou do nosso lado. Você não paga nada por ela. |
Notas técnicas
Por que tradutor comum quebra HTML
Quem já colou código em um tradutor genérico conhece o estrago: tag que some, atributo traduzido, aspas retas trocadas por aspas curvas, class="botao" virando class="button" e o CSS parando de funcionar.
O que entra e o que sai
O limite por chamada é de 20.000 tokens; para um site com muitas páginas, envie uma chamada por página e monte o processo em lote.
Cobrança por palavra, não por tamanho de arquivo
Para orçar, conte as palavras do conteúdo (qualquer editor de texto faz isso) e aplique a conta. O preço é US$ 0,003 por chamada mais US$ 0,0135 por 1.000 palavras — palavras de texto, porque marcação não é palavra. Uma landing page com 800 palavras visíveis custa cerca de US$ 0,014 para traduzir. Um site institucional de dez páginas parecidas fica na casa de US$ 0,14.
Do template de e-mail à página inteira
Funciona igual para o HTML de um e-mail marketing, para o corpo de um artigo exportado do CMS ou para o site inteiro baixado do repositório. Uma dica de fluxo: mantenha o HTML original como fonte da verdade, gere as versões traduzidas por API a cada mudança e publique as duas juntas — assim o site em espanhol nunca fica uma versão atrás do site em português.
Casos de integração
Agência entregando site bilíngue
Uma agência de Curitiba fecha sites em português e espanhol sem cobrar tradução página a página: os arquivos HTML passam pela API, o cliente revisa e o projeto sai no prazo com dois idiomas pelo custo de centavos.
Perguntas técnicas
Meu HTML é maior que o limite da chamada. E agora?
Divida por página ou por seção: o limite é de 20.000 tokens por chamada e a marcação conta para esse limite, então arquivos muito verbosos rendem mais divididos. O preço total não muda com a divisão, fora os US$ 0,003 de base de cada chamada.
Traduzir para três idiomas custa três vezes?
Sim, uma chamada por idioma de destino. A conta continua baixa: 800 palavras em três idiomas saem por cerca de US$ 0,04 no total.