Frequently Asked Questions
Everything about TOON Converter, token savings, and client-side privacy.
What is a TOON converter and how does it work?
A TOON converter is a tool that transforms JSON data into TOON (Token-Oriented Object Notation) format. It works by removing redundant syntax elements like braces, brackets, and unnecessary quotes while preserving data structure through indentation. Our TOON Converter uses a deterministic algorithm that ensures consistent output. The conversion happens entirely in your browser using JavaScript, making it fast and secure.
How much can I save by using a TOON converter?
Independent benchmarks show that a TOON converter typically achieves 30-60% token reduction. The exact savings depend on your JSON structure - deeply nested objects and arrays with repeated keys see the highest reduction. For example, with ChatGPT at $30 per million tokens, converting 1 million tokens of JSON to TOON could save $14-18 per request. For applications processing thousands of requests daily, using a TOON converter can reduce monthly API costs by 40-50%.
Do LLMs understand TOON format from the TOON Converter?
Yes, all major LLMs (ChatGPT, Claude, Gemini, etc.) can understand TOON format output from our TOON Converter. TOON uses simple, readable syntax similar to YAML, which LLMs already handle well. In fact, benchmarks show LLMs achieve 86.6% accuracy with TOON compared to 83.2% with JSON, meaning the TOON Converter not only saves tokens but can improve model performance. You can use TOON format directly in prompts without any special instructions.
Is my data safe when using the TOON Converter?
Absolutely. Our TOON Converter processes all data locally in your browser. Your JSON data never leaves your device or touches our servers. This client-side architecture makes our converter safe for sensitive data including API keys, personal information, or proprietary business data. We don't collect, store, or log any of your input or output data. The open-source nature of the TOON library also allows you to audit the code yourself.
Can I use the TOON Converter for large files?
Yes, our TOON Converter supports files up to 10MB in size. It efficiently handles complex nested structures, large arrays, and deeply nested objects. For extremely large datasets, the converter processes data in chunks to maintain browser responsiveness. If you need to convert larger files or integrate TOON conversion into your backend systems, you can use the npm package @toon-format/toon which has no size limitations.
How do I integrate the TOON Converter into my application?
While our web-based TOON Converter is great for manual conversion, you can integrate TOON conversion programmatically using the npm package. Install it with 'npm install @toon-format/toon', then use the encode() function to convert JSON to TOON format in your Node.js or browser JavaScript code. This allows you to automate conversion in data pipelines, API middleware, or LLM processing workflows. The package includes TypeScript types and works with any JavaScript runtime.
What's the difference between TOON and JSON formats?
The main difference is syntax efficiency. JSON uses braces, brackets, and quotes extensively, which consume tokens. When you use a TOON converter, these redundant characters are removed. TOON uses indentation (like YAML) to show structure and represents arrays in a tabular format when items are uniform. For example, an array of user objects in JSON repeats field names for each user, while TOON in our converter declares fields once as a header, then lists values. This makes TOON 30-60% more token-efficient while remaining human-readable.
Does the TOON Converter change my data?
No, the TOON Converter only changes the format, not the data itself. All values, data types, null values, nested structures, and relationships are preserved exactly. The converter performs lossless transformation - you can convert JSON to TOON and back to JSON without losing any information. The only change is syntax: TOON uses indentation instead of braces and comma-separated values instead of repeated key-value pairs for arrays.
Which LLM providers work best with the TOON Converter?
Our TOON Converter works excellently with all major LLM providers including OpenAI (ChatGPT), Anthropic (Claude), Google (Gemini), Cohere, and open-source models. The token savings are consistent across providers since TOON reduces the actual character count. Some users report even better results with Claude and ChatGPT as these models have stronger structural understanding. You can use TOON format in API calls, prompts, function calling, and any other LLM interaction where you currently use JSON.