~/tools / AI JSONL Checker
AI JSONL Checker — Comprueba línea por línea un JSONL de lotes o de ajuste fino
Comprueba línea por línea un archivo JSONL para la OpenAI Batch API, la Anthropic Message Batches API o el ajuste fino de OpenAI. Encuentra JSON incorrecto, valores custom_id duplicados, endpoints y parámetros no admitidos y límites de tamaño antes de subirlo. Nada sale de tu navegador.
Reglas comprobadas con la documentación el 2026-10-23.
Documentación: OpenAI Batch / Anthropic Message Batches / Ajuste fino de OpenAI
No se comprueba: los nombres de modelo, el contenido de los parámetros, el recuento de tokens y las reglas que la documentación no indica, como si todas las solicitudes de un mismo lote de OpenAI deben usar el mismo endpoint.
Todo se ejecuta en tu navegador. El archivo no se sube.
Las API por lotes y el ajuste fino aceptan un archivo JSONL, que es un valor JSON en cada línea. Una sola línea incorrecta puede hacer que falle toda la subida, y el error a menudo apunta al archivo y no a la línea. Esta herramienta lee el texto que pegas y lo comprueba con lo que dice la documentación para el formato que elijas: para OpenAI Batch, un custom_id único, un endpoint de la lista, un único modelo por archivo y sin streaming; para Anthropic Message Batches, un custom_id de 1 a 64 letras, números, guiones y guiones bajos, y los parámetros que un lote rechaza; y para el ajuste fino de OpenAI, un array messages en cada línea, al menos 10 líneas y un weight de 0 o 1. Los resultados muestran el número de línea de cada problema, y las reglas se comprobaron con la documentación en la fecha que aparece debajo de la herramienta.
Casos de uso
- Comprobar un archivo de entrada de un lote antes de subirlo, para que una línea incorrecta no haga fallar todo el lote
- Encontrar valores custom_id duplicados, o una solicitud que establece stream en true, en un archivo con miles de líneas
- Comprobar datos de ajuste fino en busca de líneas sin messages, sin respuesta del assistant o con un weight que no es 0 ni 1
Cómo usarlo
- Elige el formato: OpenAI Batch, Anthropic Message Batches o el ajuste fino de OpenAI.
- Pega el contenido del archivo o carga el ejemplo de ese formato.
- Lee la lista de problemas con sus números de línea. Corregir significa que la documentación indica que la línea será rechazada o no es válida, Revisar significa que conviene echarle un vistazo y Nota es solo informativa. Corrige el archivo y vuelve a pegarlo.
FAQ
¿Qué es JSONL?
JSON Lines: un archivo de texto con un valor JSON completo en cada línea y sin comas entre líneas. La documentación del ajuste fino de OpenAI pide una estructura JSON completa en cada línea. Un documento JSON repartido en varias líneas, o un único array, no es JSONL.
¿La Anthropic Message Batches API acepta un archivo JSONL?
Acepta una lista de solicitudes, cada una con un custom_id y un objeto params, en el parámetro requests de la llamada de creación. Sus resultados se devuelven como un archivo .jsonl. Esta herramienta trata cada línea como una solicitud, y también acepta un array JSON o un objeto con un array requests.
¿Qué límites comprueba?
Para OpenAI Batch: 50.000 solicitudes por lote, un archivo de entrada de 200 MB y 50.000 entradas de embeddings en todo el lote. Para Anthropic: 100.000 solicitudes o 256 MB por lote. Para el ajuste fino de OpenAI: al menos 10 líneas. El tamaño mostrado es el tamaño en UTF-8 del texto que pegaste.
¿Por qué indica que una solicitud con stream en true es un problema?
La documentación de OpenAI dice que el worker de Batch rechaza las solicitudes que establecen stream en true. La documentación de Anthropic enumera stream: true, speed, fallbacks y max_tokens: 0 como parámetros que devuelven un error de validación en un lote.
¿Qué no comprueba?
Los nombres de modelo, el contenido de los parámetros, el recuento de tokens, si el endpoint lo admite tu cuenta y todo lo que la documentación no indica. Por ejemplo, no dice si todas las solicitudes de un mismo lote de OpenAI deben usar el mismo endpoint. Un archivo que pasa la comprobación aún puede fallar en la API, así que prueba antes con un archivo pequeño.
¿Mi archivo se envía a un servidor?
No. La comprobación se ejecuta en tu navegador, por lo que el contenido no se sube.