.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 である必要があります。全行検証オプションを有効にすれば不正な行をアップロード前に特定できます。