.jsonl · application/x-ndjson
JSONL / NDJSON: JSON Lines / JSON Delimitado por Quebra de Linha
JSONL (Newline-Delimited JSON) armazena um valor JSON válido e independente por linha separado por \n, permitindo leitura em fluxo sem carregar arrays inteiros.
Resposta rápida: JSONL (Newline-Delimited JSON) armazena um valor JSON válido e independente por linha separado por \n, permitindo leitura em fluxo sem carregar arrays inteiros. Datasets de fine-tuning OpenAI/Anthropic/Gemini, lotes de inferência, ingestão de logs e ETL em streaming.
| Tipo de estrutura | Hierárquico |
|---|---|
| Legibilidade humana | Média |
| Suporte a aninhamento | Sim |
| Eficiência de tokens LLM | Média |
| Extensão do arquivo | .jsonl |
| Tipo MIME | application/x-ndjson |
| Indicado para | Datasets de fine-tuning OpenAI/Anthropic/Gemini, lotes de inferência, ingestão de logs e ETL em streaming. |
Pontos fortes
- Formato exigido pelas APIs de fine-tuning e batch da OpenAI, Claude e Vertex AI
- Anexa e transmite registro a registro sem analisar um colchete externo [ ... ]
- Um registro malformado afeta apenas uma linha sem invalidar o restante do arquivo
Limitações
- Objetos JSON formatados em várias linhas são inválidos dentro de uma linha JSONL
- Não pode ser lido diretamente por uma única chamada simples JSON.parse()
- Ainda repete os nomes de campo JSON em todas as linhas
Referências
Converter e limpar JSONL / NDJSON localmente
Guias técnicos relacionados
- Criando Datasets JSONL Válidos para Fine-Tuning a Partir de CSV e JSONFormate arquivos .jsonl válidos de fine-tuning para OpenAI Chat, Alpaca e Gemini direto de planilhas e arrays JSON no navegador.
- TOON vs JSON: Reduzindo o Custo de Tokens em Prompts de LLM em 30–60%Veja como a notação TOON elimina chaves JSON repetidas em arrays uniformes para cortar custos de prompts no GPT-5, Claude 4 e Gemini 2.5.
Formatos relacionados
Todos os 24 formatosPerguntas frequentes sobre JSONL / NDJSON
JSONL é a mesma coisa que NDJSON?
Na prática sim. JSON Lines (.jsonl) e Newline-Delimited JSON (.ndjson) colocam um objeto JSON compacto em UTF-8 por linha separado por \n.
Posso converter um CSV direto para JSONL de fine-tuning da OpenAI?
Sim. CSV para JSONL traz modelos prontos para objetos brutos, arrays messages de chat da OpenAI e datasets Alpaca instruction/input/output.
Por que a validação de fine-tuning rejeita linhas vazias ou JSON identado?
Cada linha em JSONL deve conter um valor JSON completo em linha única. Ativar a validação por linha aponta linhas vazias ou quebradas antes do envio.