.toon · text/plain
TOON: TOON(トークン指向オブジェクト記法)
TOON は、ネスト構造に YAML 風のインデントを用い、均一配列を宣言的ヘッダー(`items[N]{col1,col2}:`)と CSV 風行データで表すトークン節約フォーマットです。
クイックアンサー: TOON は、ネスト構造に YAML 風のインデントを用い、均一配列を宣言的ヘッダー(`items[N]{col1,col2}:`)と CSV 風行データで表すトークン節約フォーマットです。 均一な JSON オブジェクト配列を GPT-5、Claude 4、Gemini へ渡す際の LLM トークンコスト 30〜60% 削減。
| 構造タイプ | 階層構造 |
|---|---|
| 可読性 | 高 |
| ネスト対応 | 対応 |
| LLM トークン効率 | 高 |
| 拡張子 | .toon |
| MIME タイプ | text/plain |
| 主な用途 | 均一な JSON オブジェクト配列を GPT-5、Claude 4、Gemini へ渡す際の LLM トークンコスト 30〜60% 削減。 |
メリット
- 構造化レコード配列における LLM 入力トークン消費量を 30%〜60% 削減
- 要素数 [N] とフィールドヘッダーを明示するためモデルの解釈精度が高い
- @toon-format/toon により型付き JSON へ損失なく完全復元できる
注意点・トレードオフ
- 新しいフォーマットのため標準ブラウザの JSON API では直接パースできない
- 各要素のキー構成がバラバラな不均一ツリーでは削減効果が小さくなる
- LLM 入出力の境界で変換・逆変換のステップが必要になる
参考文献
TOON をローカルで変換・整形
関連エンジニアリングガイド
- TOON vs JSON:LLM プロンプトのトークンコストを 30〜60% 削減TOON 形式が均一配列で重複する JSON キーを排除し、GPT-5・Claude 4・Gemini 2.5 の入力トークンコストを半減させる仕組みを解説します。
- CSV・JSON から有効な LLM ファインチューニング用 JSONL データセットを作成スプレッドシートや JSON 配列から OpenAI Chat・Alpaca・Gemini ファインチューニング用の有効な .jsonl を全行検証付きでローカル生成します。
- PDF・Word・Excel を RAG・LLM 向けのクリーンな Markdown へ変換する方法機密性の高い PDF、Word (DOCX)、Excel シートをサーバー送信なしで構造化された Markdown へ抽出し、ベクトル検索や LLM 入力に最適化します。
- JSON から TypeScript・Zod・Pydantic v2 スキーマを自動生成して型安全を確保API の JSON サンプルから TypeScript インターフェース、実行時 Zod バリデータ、Python Pydantic v2 BaseModel を省略可能・エイリアス推論付きで生成。
関連フォーマット
全24形式を見るTOON に関するよくある質問
TOON は JSON と比べてどの程度 LLM トークンを削減できますか?
DB レコードや API 一覧のような均一オブジェクト配列では、キー名をヘッダーで1回だけ宣言することで通常 35%〜60% のトークンを削減できます。
TOON から JSON に戻したとき、数値や真偽値などの型は失われませんか?
失われません。文字列、数値、真偽値、null、ネストオブジェクト・配列がそのまま元の JSON 型として正確に復元されます。
TOON の表ブロックではどの区切り文字を使うのが効果的ですか?
標準のカンマが最も読みやすく、値にスペースやカンマが多い場合はタブ(\t)やパイプ(|)を選ぶと o200k_base でさらに数%削減できます。