.jsonl · application/x-ndjson

JSONL / NDJSON: JSON Lines / 줄바꿈 구분 JSON (JSONL)

JSONL(NDJSON)은 한 줄에 하나의 온전한 JSON 값을 \n 구분자로 저장하여, 전체 배열을 메모리에 올리지 않고 줄 단위 스트리밍 처리를 가능하게 합니다.

빠른 답변: JSONL(NDJSON)은 한 줄에 하나의 온전한 JSON 값을 \n 구분자로 저장하여, 전체 배열을 메모리에 올리지 않고 줄 단위 스트리밍 처리를 가능하게 합니다. OpenAI·Anthropic·Gemini 파인튜닝 데이터셋, 배치 추론 작업, 로그 수집 및 스트리밍 ETL.

구조 유형계층형
사람 가독성보통
중첩 지원지원
LLM 토큰 효율보통
파일 확장자.jsonl
MIME 유형application/x-ndjson
추천 용도OpenAI·Anthropic·Gemini 파인튜닝 데이터셋, 배치 추론 작업, 로그 수집 및 스트리밍 ETL.

장점

  • OpenAI, Claude, Vertex AI 파인튜닝 및 배치 API가 요구하는 표준 형식
  • 외부 [ ... ] 배열 래퍼를 파싱하지 않고 레코드 단위로 추가 및 스트리밍 가능
  • 한 줄이 손상되어도 파일 전체가 깨지지 않고 해당 줄에만 영향을 미침

단점 및 주의사항

  • 여러 줄로 예쁘게 들여쓰기된 JSON 객체는 단일 JSONL 줄 규칙상 유효하지 않음
  • 단순한 단일 JSON.parse() 호출 한 번으로는 전체 파일을 파싱할 수 없음
  • 매 줄마다 JSON 필드 이름을 반복한다는 점 자체는 JSON과 동일함

참고 자료

JSONL / NDJSON 로컬 변환 및 정리 도구

관련 엔지니어링 가이드

JSONL / NDJSON 자주 묻는 질문

JSONL과 NDJSON은 같은 형식인가요?

실무적으로 같습니다. JSON Lines(.jsonl)와 Newline-Delimited JSON(.ndjson) 모두 한 줄에 하나씩 압축된 UTF-8 JSON 객체를 \n으로 구분합니다.

CSV 파일을 바로 OpenAI 채팅 파인튜닝용 JSONL로 변환할 수 있나요?

네. CSV to JSONL에는 원시 객체, OpenAI Chat(messages[]), Alpaca(instruction/input/output) 프리셋 템플릿이 내장되어 있습니다.

파인튜닝 업로드 검증에서 끝의 빈 줄이나 여러 줄 JSON이 실패하는 이유는 무엇인가요?

JSONL은 모든 줄이 한 줄짜리 유효한 JSON이어야 합니다. '모든 줄 개별 검증' 옵션을 켜면 업로드 전에 잘못된 줄을 즉시 찾아낼 수 있습니다.