¿Qué es el formato TOON?

TOON (Token-Oriented Object Notation) es un formato de serialización de datos compacto y legible diseñado específicamente para Modelos de Lenguaje Grande (LLMs). A diferencia de JSON, que repite los nombres de campos para cada objeto en un array, TOON declara los nombres de campos una vez y luego transmite datos en filas—similar a CSV pero con estructura explícita. Este diseño típicamente reduce el uso de tokens en un 30-60% comparado con JSON formateado, especialmente para arrays uniformes de objetos. TOON combina la estructura basada en indentación de YAML para objetos anidados con la eficiencia tabular de CSV, optimizada para contextos LLM donde los costos de tokens importan.

Descripción de la herramienta

Este convertidor transforma datos entre formatos JSON y TOON bidireccionalmente. Simplemente pegue sus datos JSON para generar salida TOON compacta, o convierta TOON de vuelta a JSON estándar. La herramienta utiliza la biblioteca oficial @toon-format/toon para garantizar conversión precisa. TOON es particularmente efectivo para conjuntos de datos con estructuras repetidas—como registros de usuarios, registros de transacciones, respuestas API o cualquier dato tabular—donde reducir el conteo de tokens mejora la eficiencia al trabajar con LLMs.

Ejemplos

Entrada JSON:

{
  "users": [
    { "id": 1, "name": "Alice", "role": "admin" },
    { "id": 2, "name": "Bob", "role": "user" }
  ]
}

Salida TOON:

users[2]{id,name,role}:
  1,Alice,admin
  2,Bob,user

Ejemplo de estructura anidada:

JSON con objetos anidados se convierte a formato TOON indentado:

{
  "order": {
    "id": "ORD-456",
    "items": [
      { "sku": "A1", "qty": 2, "price": 19.99 },
      { "sku": "B2", "qty": 1, "price": 29.99 }
    ],
    "total": 69.97
  }
}

Se convierte en:

order:
  id: ORD-456
  items[2]{sku,qty,price}:
    A1,2,19.99
    B2,1,29.99
  total: 69.97

Características

  • Conversión bidireccional entre formatos JSON y TOON con total fidelidad
  • Reducción significativa de tokens (30-60% menos tokens vs JSON para arrays uniformes)
  • Preserva la estructura de datos incluyendo objetos anidados, arrays y valores primitivos
  • Detección automática de formato y estrategia de codificación óptima
  • Salida legible con estructura tabular clara para datos uniformes
  • Conversión type-safe manteniendo correctamente números, booleanos, null y strings
  • Maneja casos extremos incluyendo arrays vacíos, estructuras anidadas y tipos mixtos
  • Conversión en tiempo real con resultados instantáneos mientras escribes

Casos de uso

  1. Optimización de API LLM - Reducir costos de tokens al enviar datos estructurados a GPT, Claude u otros LLMs convirtiendo payloads JSON a formato TOON antes de llamadas API
  2. Prompts de análisis de datos - Preparar conjuntos de datos para análisis LLM con codificación más eficiente, permitiendo conjuntos de datos más grandes dentro de límites de contexto
  3. Generación de datos estructurados - Usar TOON en prompts para solicitar a LLMs generar datos tabulares más eficientemente que JSON
  4. Procesamiento de registros - Convertir registros de aplicaciones o datos analíticos a formato compacto para análisis y resumen basados en LLM
  5. Gestión de configuración - Transformar archivos de configuración a formato eficiente en tokens al usar LLMs para gestión de infraestructura o tareas DevOps

Detalles de eficiencia de tokens

TOON logra ahorros significativos de tokens mediante varias optimizaciones:

  • Sin nombres de campos repetidos - Declara campos una vez en el encabezado en lugar de repetir para cada objeto
  • Puntuación mínima - Elimina corchetes, llaves y comillas redundantes donde es seguro
  • Formato tabular - Usa filas tipo CSV para arrays uniformes de objetos
  • Flexibilidad de delimitadores - Soporta coma (predeterminado), tabulación o pipe para tokenización óptima

Ejemplo de comparación de tokens (usando tokenizador GPT-5):

  • JSON (formateado): 100 registros de empleados ≈ 49.776 tokens
  • TOON: Mismos datos ≈ 17.635 tokens (reducción del 64,6%)
  • CSV: ≈ 15.583 tokens (más compacto, pero sin estructura)

TOON proporciona el mejor balance entre compacidad e integridad estructural para aplicaciones LLM.

Descripción general del formato

Objetos: Pares clave-valor simples con indentación para anidación

id: 123
name: Ada
active: true

Arrays: Longitud declarada entre corchetes, arrays primitivos en línea

tags[3]: reading,gaming,coding

Arrays tabulares: Objetos uniformes formateados como tablas con encabezados de campos

items[2]{sku,qty,price}:
  A1,2,9.99
  B2,1,14.5

Reglas de comillas: Los strings se entrecomillan solo cuando es necesario (contienen delimitadores, dos puntos o parecen otros tipos)

Notas de conversión

Al convertir JSON a TOON:

  • Arrays uniformes de objetos usan automáticamente formato tabular
  • Estructuras anidadas mantienen indentación adecuada
  • Tipos no-JSON (undefined, funciones) se convierten a null
  • Fechas se convierten a strings ISO
  • Números evitan notación científica

Al convertir TOON a JSON:

  • Mantiene formato JSON estándar con indentación de 2 espacios
  • Valida longitudes de arrays y consistencia de campos
  • Escapa correctamente caracteres especiales
  • Preserva información de tipos (números, booleanos, null)