.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 로컬 변환 및 정리 도구
관련 엔지니어링 가이드
관련 형식
24개 형식 전체 보기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이어야 합니다. '모든 줄 개별 검증' 옵션을 켜면 업로드 전에 잘못된 줄을 즉시 찾아낼 수 있습니다.