.jsonl · application/x-ndjson
JSONL / NDJSON: JSON Lines / 改行区切り JSON(JSONL)
JSONL(NDJSON)は、1 行につき 1 つの完結した JSON 値を改行 \n 区切りで格納し、配列全体を読み込まずに逐次ストリーミング処理できる形式です。
クイックアンサー: JSONL(NDJSON)は、1 行につき 1 つの完結した JSON 値を改行 \n 区切りで格納し、配列全体を読み込まずに逐次ストリーミング処理できる形式です。 OpenAI・Anthropic・Gemini のファインチューニング用データセット、バッチ推論、ログ収集、ストリーミング ETL。
| 構造タイプ | 階層構造 |
|---|---|
| 可読性 | 中 |
| ネスト対応 | 対応 |
| LLM トークン効率 | 中 |
| 拡張子 | .jsonl |
| MIME タイプ | application/x-ndjson |
| 主な用途 | OpenAI・Anthropic・Gemini のファインチューニング用データセット、バッチ推論、ログ収集、ストリーミング ETL。 |
メリット
- OpenAI、Claude、Vertex AI のファインチューニングおよびバッチ API の必須形式
- 外側の [ ... ] ラッパーを解析せず末尾追記や1行ずつのストリーム処理が可能
- 1 行だけ破損してもファイル全体が読めなくなる事態を防げる
注意点・トレードオフ
- 複数行に整形された JSON オブジェクトは 1 行 1 レコードの規則に反し無効
- 単一の素の JSON.parse() 呼び出しだけではファイル全体を一括パースできない
- 各行で JSON のプロパティ名を繰り返す点自体は JSON と変わらない
参考文献
JSONL / NDJSON をローカルで変換・整形
関連エンジニアリングガイド
関連フォーマット
全24形式を見るJSONL / NDJSON に関するよくある質問
JSONL と NDJSON は同じフォーマットですか?
実務上ほぼ同一です。JSON Lines (.jsonl) も Newline-Delimited JSON (.ndjson) も、1 行ごとに圧縮された UTF-8 JSON オブジェクトを \n で区切ります。
CSV から直接 OpenAI チャット学習用の JSONL を作れますか?
はい。CSV to JSONL には Raw オブジェクト、OpenAI Chat (messages[])、Alpaca (instruction/input/output) のテンプレートが内蔵されています。
学習データのアップロード検証で末尾の空行や整形 JSON が弾かれるのはなぜですか?
JSONL は全行が単一行の有効な JSON である必要があります。全行検証オプションを有効にすれば不正な行をアップロード前に特定できます。