Como converter JSON para TOON
- Cole o JSON ou abra um arquivo. A saída em TOON e uma estimativa dos tokens economizados aparecem na hora.
- Escolha o delimitador: vírgula (padrão), tabulação ou barra vertical. Tabulações costumam exigir ainda menos tokens.
- Copie o TOON para o seu prompt. Para ler uma resposta em TOON de um modelo, mude a direção para TOON → JSON.
TOON vs JSON: um exemplo
Os mesmos dois usuários em JSON:
{"users":[{"id":1,"name":"Ada","role":"admin"},{"id":2,"name":"Bob","role":"user"}]}
e em TOON:
users[2]{id,name,role}:1,Ada,admin2,Bob,user
Os nomes dos campos são escritos uma única vez no cabeçalho, em vez de uma vez por objeto, e as aspas, as chaves e a maior parte da pontuação desaparecem. Em arrays uniformes de objetos – linhas de banco de dados, logs, resultados de busca, listas de produtos – a economia é grande: no nosso teste com 100 registros de clientes, o TOON precisou de cerca de 65% menos tokens que o JSON formatado e 47% menos que o JSON minificado. O marcador de tamanho [2] também permite que o modelo e o decodificador confiram se nenhuma linha está faltando.
O formato TOON em resumo
| Dados | TOON |
|---|---|
| Campo de objeto | name: Ada |
| Objeto aninhado | address: seguido dos campos indentados |
| Array de valores simples | tags[3]: red,green,blue |
| Array de objetos com as mesmas chaves | users[2]{id,name}: seguido de uma linha por objeto |
| Arrays mistos ou aninhados | items[2]: seguido de itens de lista com - |
| Strings | sem aspas, a menos que contenham o delimitador, dois-pontos, aspas ou colchetes, tenham espaços nas pontas ou pareçam um número, true, false ou null |
Quando o JSON ainda é a melhor escolha
- Dados muito aninhados ou irregulares – quando os objetos têm chaves diferentes ou contêm objetos aninhados, o TOON recorre a listas indentadas e a economia diminui ou desaparece. Com 20 registros que continham, cada um, um endereço aninhado e uma lista de tags, o TOON ainda foi 34% menor que o JSON formatado, mas 12% maior que o JSON minificado. O conversor mostra as duas comparações para os seus dados.
- Interfaces entre máquinas – APIs, function calling e saídas estruturadas esperam JSON.
- Familiaridade do modelo – os modelos de linguagem viram muito mais JSON do que TOON; avalie a qualidade das respostas com os seus próprios prompts antes de migrar.
- Payloads minúsculos – com poucos valores, a diferença é desprezível.
A contagem de tokens é estimada como caracteres ÷ 4. Os números exatos dependem do tokenizador do seu modelo, mas a diferença relativa é uma boa referência.
Perguntas frequentes
O que é TOON?
TOON (Token-Oriented Object Notation) é uma codificação compacta e legível do modelo de dados do JSON, criada para prompts de LLM. Ela combina a indentação no estilo YAML para objetos com linhas no estilo CSV para arrays uniformes.
TOON é melhor que JSON?
Para enviar dados tabulares ou uniformes a um modelo de linguagem, geralmente sim: menos tokens e tamanhos de array explícitos. Para APIs, armazenamento e dados muito aninhados, o JSON continua sendo a melhor escolha.
Como os tokens são estimados?
A ferramenta divide o número de caracteres por quatro, uma regra prática comum para textos em inglês e código. A contagem exata depende do tokenizador do seu modelo.
Posso converter TOON de volta para JSON?
Sim. Mude a direção para TOON → JSON; o decodificador confere os tamanhos de array declarados e informa a linha de qualquer problema.