.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 estruturaHierárquico
Legibilidade humanaMédia
Suporte a aninhamentoSim
Eficiência de tokens LLMMédia
Extensão do arquivo.jsonl
Tipo MIMEapplication/x-ndjson
Indicado paraDatasets 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

Formatos relacionados

Todos os 24 formatos

Perguntas 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.