~/tools / AI JSONL Checker
AI JSONL Checker — 배치·파인튜닝용 JSONL 파일을 한 줄씩 검사
OpenAI Batch API, Anthropic Message Batches API, OpenAI 파인튜닝용 JSONL 파일을 한 줄씩 검사합니다. 업로드하기 전에 잘못된 JSON, 중복된 custom_id, 지원하지 않는 엔드포인트와 파라미터, 크기 제한을 찾아냅니다. 입력한 내용은 브라우저 밖으로 나가지 않습니다.
2026-10-23에 문서와 대조해 규칙을 확인했습니다.
문서: OpenAI Batch / Anthropic Message Batches / OpenAI fine-tuning
검사하지 않는 것: 모델 이름, 파라미터의 내용, 토큰 수, 그리고 OpenAI 배치 하나 안의 모든 요청이 같은 엔드포인트를 써야 하는지처럼 문서에 적혀 있지 않은 규칙.
모든 처리는 브라우저 안에서 실행됩니다. 파일은 업로드되지 않습니다.
배치 API와 파인튜닝은 모든 줄에 JSON 값이 하나씩 들어 있는 JSONL 파일을 받습니다. 잘못된 줄이 하나만 있어도 업로드 전체가 실패할 수 있고, 오류가 문제의 줄이 아니라 파일 전체를 가리키는 경우가 많습니다. 이 도구는 붙여넣은 텍스트를 읽고, 선택한 형식에 대해 문서에 적힌 규칙대로 검사합니다. OpenAI Batch는 고유한 custom_id, 목록에 있는 엔드포인트, 파일당 모델 하나, 스트리밍 금지를 확인합니다. Anthropic Message Batches는 영문자·숫자·하이픈·밑줄로 이루어진 1~64자의 custom_id와 배치에서 거부되는 파라미터를 확인합니다. OpenAI 파인튜닝은 모든 줄의 messages 배열, 최소 10줄, 0 또는 1인 weight를 확인합니다. 결과에는 문제마다 줄 번호가 표시되며, 규칙을 문서와 대조한 날짜는 도구 아래에 나와 있습니다.
이럴 때 사용
- 배치 입력 파일을 업로드하기 전에 검사해, 잘못된 줄 하나 때문에 배치 전체가 실패하지 않도록 하기
- 수천 줄짜리 파일에서 중복된 custom_id나 stream을 true로 설정한 요청 찾기
- 파인튜닝 데이터에서 messages가 없거나, assistant 응답이 없거나, weight가 0 또는 1이 아닌 줄 찾기
사용법
- 형식을 고릅니다. OpenAI Batch, Anthropic Message Batches, OpenAI 파인튜닝 중에서 선택합니다.
- 파일의 내용을 붙여넣거나, 해당 형식의 예시를 불러옵니다.
- 줄 번호가 붙은 문제 목록을 확인합니다. 수정은 문서상 그 줄이 거부되거나 올바르지 않다는 뜻이고, 확인은 살펴볼 만하다는 뜻이며, 참고는 정보 제공용입니다. 파일을 고친 뒤 다시 붙여넣으세요.
FAQ
JSONL이란 무엇인가요?
JSON Lines의 약자로, 모든 줄에 완전한 JSON 값이 하나씩 있고 줄 사이에 쉼표가 없는 텍스트 파일입니다. OpenAI 파인튜닝 문서는 모든 줄에 완전한 JSON 구조가 하나씩 있어야 한다고 설명합니다. 여러 줄에 걸쳐 쓴 JSON 문서나 단일 배열은 JSONL이 아닙니다.
Anthropic Message Batches API는 JSONL 파일을 받나요?
생성 호출의 requests 파라미터에, 각각 custom_id와 params 객체를 가진 요청의 목록을 받습니다. 결과는 .jsonl 파일로 돌아옵니다. 이 도구는 각 줄을 요청 하나로 취급하며, JSON 배열이나 requests 배열을 가진 객체도 받아들입니다.
어떤 제한을 검사하나요?
OpenAI Batch는 배치당 요청 50,000개, 입력 파일 200 MB, 배치 전체에서 임베딩 입력 50,000개입니다. Anthropic은 배치당 요청 100,000개 또는 256 MB입니다. OpenAI 파인튜닝은 최소 10줄입니다. 표시되는 크기는 붙여넣은 텍스트의 UTF-8 기준 크기입니다.
stream을 true로 설정한 요청이 왜 문제라고 나오나요?
OpenAI 문서에 따르면 Batch 워커는 stream을 true로 설정한 요청을 거부합니다. Anthropic 문서는 stream: true, speed, fallbacks, max_tokens: 0을 배치에서 검증 오류가 반환되는 파라미터로 나열합니다.
무엇은 검사하지 않나요?
모델 이름, 파라미터의 내용, 토큰 수, 내 계정에서 그 엔드포인트를 쓸 수 있는지, 그리고 문서에 적혀 있지 않은 모든 것입니다. 예를 들어 OpenAI 배치 하나 안의 모든 요청이 같은 엔드포인트를 써야 하는지는 알려 주지 않습니다. 검사를 통과한 파일도 API에서 실패할 수 있으니, 먼저 작은 파일로 시험해 보세요.
내 파일이 서버로 전송되나요?
아니요. 검사는 브라우저 안에서 실행되므로 내용이 업로드되지 않습니다.