ForHosting KIT · Tradução

Traduzir JSON de i18n

Traduzir JSON é feito para arquivos de i18n: você envia o en.json do seu app e recebe o pt.json (ou es.json, fr.json…) com as mesmas chaves, os mesmos placeholders e só os valores traduzidos. O resultado volta como JSON válido, pronto para entrar no repositório e no build.

● Estávelpor chaveUS$ 0,003

Executar — US$ 0,003 + US$ 0,0135/chave Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

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.

Chaves, placeholders e HTML embutido

A regra da ferramenta é simples: chave não se traduz, valor sim. welcome_message continua welcome_message; "Bem-vindo, {name}!" vira "Welcome, {name}!" com o placeholder no lugar. Variáveis nos formatos mais comuns — {name}, {{count}}, %s, :id — são preservadas, e valores com marcação leve (um negrito, um link) mantêm a marcação. Objetos aninhados e arrays passam pelo mesmo tratamento, nível por nível, sem achatar a estrutura.

Preço por chave, bom para arquivos de app

A cobrança é US$ 0,003 por chamada mais US$ 0,0135 por chave traduzida. Um arquivo típico de aplicativo, com 300 chaves, custa US$ 4,05 mais a base — pronto em minutos, sem depender da agenda de ninguém. Como strings de interface são curtas, o modelo por chave é mais previsível que o modelo por palavra: você sabe o custo antes de rodar, contando as chaves com um script de uma linha.

Do en.json ao lançamento em outro mercado

O fluxo que funciona: escolha o arquivo de idioma mais completo como fonte, rode uma chamada por idioma de destino e valide os resultados com JSON.parse no seu CI. Depois, peça para alguém do time revisar as strings mais visíveis — menu, onboarding, mensagens de erro. Interface tem contexto apertado (botão de uma palavra, título truncado), e uma revisão rápida evita constrangimento em produção.

Limites e arquivos grandes

Cada chamada aceita até 20.000 tokens. Arquivos de i18n raramente passam disso, mas se o seu projeto tem milhares de chaves, divida por namespace — common.json, checkout.json, emails.json — e mande uma chamada por arquivo. A divisão por domínio também melhora o resultado da tradução: o modelo pega o contexto de cada arquivo e escolhe termos mais consistentes dentro daquele pedaço específico do produto.

Casos de uso

App indo para o mercado hispânico

Um app de delivery de Belo Horizonte lançou a versão em espanhol: 420 chaves traduzidas por menos de US$ 6, revisadas pela própria equipe em uma tarde — sem agência, sem planilha de strings circulando por e-mail.

SaaS com três idiomas no pipeline

O arquivo pt.json é a fonte; a cada release, o CI gera en.json e es.json por API e valida tudo com JSON.parse antes do merge. Idioma novo deixou de ser projeto e virou etapa do build.

Tema ou plugin distribuído

Quem vende template ou plugin precisa entregar as strings em inglês para o marketplace. O arquivo de idioma sai traduzido em minutos e o produto passa a concorrer fora do Brasil.

Chatbot multilíngue

As respostas do bot, mantidas em JSON, ganham versão em espanhol com as variáveis de nome e protocolo preservadas — o fluxo de conversa não muda, só o idioma.

Perguntas frequentes

As chaves do JSON também mudam?

Não — se mudassem, o app quebraria. Chave, estrutura e tipos permanecem; a tradução acontece só nos valores de texto.

E se um valor tiver uma variável tipo {nome} no meio?

Ela é preservada como está, na posição que a frase traduzida pedir. Placeholders nos formatos comuns ({x}, {{x}}, %s, :x) não são traduzidos.

Quanto custa um arquivo com 1.000 chaves?

US$ 13,50 (1.000 × US$ 0,0135) mais US$ 0,003 da chamada. Para orçar qualquer arquivo, basta contar as chaves.

O resultado sempre volta JSON válido?

Sim, com a mesma estrutura do arquivo enviado. Mesmo assim, valide com JSON.parse no seu CI — custa zero e garante o merge tranquilo.

Minhas strings têm nomes e e-mails de teste. Tem problema?

O arquivo é processado para gerar a tradução e devolvido, sem outro uso. Ainda assim, a boa prática da LGPD vale aqui como em qualquer serviço: prefira dados fictícios nos arquivos de exemplo.

Vocês emitem nota fiscal brasileira?

Não emitimos NF-e: a compra é internacional, paga em dólares via PayPal, e o comprovante da transação vem do próprio PayPal. Muitas contabilidades aceitam o comprovante como documento da despesa — confirme com o seu contador.

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

POSThttps://api.kit.forhosting.com/translate/json

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/json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/translate/json", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/translate/json",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/json", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/json", 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

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "translate.json",
  "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

por chamadaUS$ 0,003

por chaveUS$ 0,0135

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.

Ver a documentação completa do KIT →