Skill · Claude Blog - Message Batches API
Procesa 10.000 tareas al 50 % del coste con la API Batch de Claude
Foto: Antonio Vivace en Unsplash
Deja de pagar el precio completo por cargas de trabajo de IA no urgentes. La API Batch de Claude procesa hasta 100.000 solicitudes de forma asíncrona a la mitad del coste estándar, completándolas en un plazo de 24 horas. Ideal para clasificación de documentos, enriquecimiento masivo de datos y análisis a gran escala con un presupuesto predecible.
La API Message Batches de Claude está diseñada para cargas de trabajo profesionales que no requieren respuestas en tiempo real, como la clasificación de documentos, el análisis de contenido, la extracción de datos o la síntesis de investigación a gran escala. En lugar de enviar solicitudes individuales al precio estándar de la API, se empaquetan hasta 100.000 consultas en una única entrega por lotes, y Claude las procesa de forma asíncrona exactamente al 50 % del coste por token.
Así se implementa: utiliza el SDK de Python de Anthropic para crear un lote con una lista de solicitudes de mensajes, cada una etiquetada con un custom_id. Cada solicitud sigue el formato estándar de la API Messages: modelo, max_tokens, prompt de sistema y mensajes. Una vez enviado mediante client.beta.messages.batches.create(), la API asigna un ID de lote y comienza el procesamiento. Los resultados suelen estar disponibles en una hora (aunque la plataforma garantiza la finalización en 24 horas), y puedes consultar el estado con client.beta.messages.batches.retrieve(batch_id). Los resultados se conservan durante 29 días.
Ejemplo práctico: un equipo de cumplimiento necesita clasificar 5.000 contratos de proveedores por categoría de riesgo. Usar llamadas estándar a la API costaría 500 dólares; el mismo lote cuesta 250. Configura las solicitudes con instrucciones como «Clasifica este contrato como riesgo ALTO, MEDIO o BAJO según las condiciones de pago, las cláusulas de responsabilidad y las condiciones de rescisión», adjunta cada contrato como custom_id, envía el lote y recoge los resultados de un día para otro. Sin esperas en tiempo real, sin derroche de tokens.
La limitación clave: el streaming y el modo rápido no son compatibles con los lotes, por lo que esto funciona mejor para tareas en las que ya dispones de una colección de entradas y puedes tolerar un procesamiento asíncrono. Combina el procesamiento por lotes con el almacenamiento en caché de prompts de Claude para obtener ahorros aún mayores en contextos repetidos: las empresas informan de que apilan ambas técnicas para lograr reducciones de costes del 75 % en operaciones a gran escala.
Fuentes y créditos
Fuente original: Claude Blog - Message Batches API