.jsonl · application/x-ndjson
JSONL / NDJSON: JSON Lines / JSON Delimitado por Saltos
JSONL (JSON Delimitado por Saltos) guarda un valor JSON completo por línea separado con \n para procesarse en streaming.
Respuesta rápida: JSONL (JSON Delimitado por Saltos) guarda un valor JSON completo por línea separado con \n para procesarse en streaming. Datasets de fine-tuning para OpenAI/Anthropic/Gemini, trabajos batch, ingesta de logs y ETL en streaming.
| Tipo de estructura | Jerárquico |
|---|---|
| Legibilidad humana | Media |
| Soporte de anidación | Sí |
| Eficiencia de tokens LLM | Media |
| Extensión de archivo | .jsonl |
| Tipo MIME | application/x-ndjson |
| Ideal para | Datasets de fine-tuning para OpenAI/Anthropic/Gemini, trabajos batch, ingesta de logs y ETL en streaming. |
Ventajas
- Formato exigido en APIs de ajuste fino y lotes de OpenAI, Claude y Vertex AI
- Permite añadir y leer registro por registro sin cargar un arreglo [ ... ] entero
- Una línea dañada afecta solo a un registro en lugar de invalidar todo el archivo
Compromisos
- Los objetos JSON con saltos e indentación son inválidos dentro de JSONL
- No puede analizarse directamente con una sola llamada a JSON.parse()
- Sigue repitiendo nombres de propiedades JSON en cada línea
Referencias
Convierte y limpia JSONL / NDJSON localmente
Guías técnicas relacionadas
- Crear datasets JSONL válidos para fine-tuning desde CSV y JSONGenera archivos .jsonl válidos para fine-tuning de OpenAI chat, Alpaca y Gemini desde hojas de cálculo y arreglos JSON en local con validación por línea.
- TOON frente a JSON: Reduce un 30–60% los tokens en prompts LLMDescubre cómo Token-Oriented Object Notation (TOON) elimina claves JSON repetidas para ahorrar costos de tokens en GPT-5, Claude 4 y Gemini 2.5.
Formatos relacionados
Los 24 formatosPreguntas frecuentes sobre JSONL / NDJSON
¿JSONL es lo mismo que NDJSON?
En la práctica sí. Tanto JSON Lines (.jsonl) como Newline-Delimited JSON (.ndjson) colocan un objeto JSON compacto en UTF-8 por cada línea.
¿Puedo convertir un CSV directamente a JSONL de chat para OpenAI?
Sí. CSV a JSONL incluye plantillas predefinidas para objetos crudos, arreglos messages de OpenAI Chat y datasets Alpaca.
¿Por qué falla la validación de fine-tuning por líneas vacías o JSON indentado?
Cada línea de JSONL debe ser un valor JSON completo en una sola línea. Activar la validación por línea detecta errores antes de subir.