Tutorial de la API por lotes de Claude Fable 5.2: Procesa grandes cargas de trabajo a menor costo
Usa Claude Fable 5.2 con la API de Message Batches para análisis asincrónico de documentos, revisión de código y evaluaciones al 50% de las tarifas estándar de tokens.

La API de Lotes de Mensajes es la ruta económica para trabajos que no requieren una respuesta inmediata. Anthropic actualmente cobra la entrada y salida por lotes de Claude Fable 5.2 al 50% de las tarifas estándar: $4 y $20 por millón de tokens en lugar de $8 y $40.
El procesamiento por lotes no es un modo interactivo más rápido. Un lote puede tardar hasta 24 horas, los resultados llegan como un archivo en lugar de un flujo, y cada solicitud debe diseñarse para que pueda ser emparejada, validada y reintentada de forma independiente.
Cargas de trabajo que se adaptan al procesamiento por lotes
- Evaluando miles de indicaciones contra una rúbrica fija
- Clasificar o extraer campos de colecciones de documentos
- Revisando cambios de código independientes
- Creación de resúmenes de investigación sin conexión
- Generando metadatos para un archivo de contenido
- Reprocesamiento de casos de soporte históricos
- Ejecutando comparaciones de migración de modelos
Evita el procesamiento por lotes cuando una persona está esperando, las solicitudes posteriores dependen de respuestas anteriores, o las herramientas deben interactuar con un sistema externo que cambia rápidamente.
Diseña cada solicitud como una unidad independiente
Cada solicitud necesita un custom_id único. El servicio puede devolver resultados fuera del orden de envío, por lo que nunca debe coincidir por posición en el arreglo.
from anthropic import Anthropic
client = Anthropic()
batch = client.messages.batches.create(
requests=[
{
"custom_id": "contract_0001",
"params": {
"model": "claude-fable-5-2",
"max_tokens": 2048,
"messages": [{
"role": "usuario",
"content": "Extraer fechas de terminación y citar las cláusulas relevantes."
}],
},
},
{
"custom_id": "contract_0002",
"params": {
"model": "claude-fable-5-2",
"max_tokens": 2048,
"messages": [{
"role": "usuario",
"content": "Extraer fechas de terminación y citar las cláusulas relevantes."
}],
},
},
]
)
En un flujo de trabajo real, incluya el contenido del documento apropiado o las referencias de archivos y conserve un manifiesto que vincule custom_id con la fuente, la versión, el esquema esperado y los permisos.
El ciclo de vida del procesamiento
- Validar solicitudes localmente.
- Enviar el lote.
- Almacene el ID del lote y el manifiesto de entrada.
- Realice la encuesta en un intervalo razonable o utilice el flujo de trabajo de estado compatible.
- Descargue los resultados después de que finalice el procesamiento.
- Empareja cada resultado por
custom_id. - Separe los elementos exitosos, con error, vencidos, cancelados y rechazados.
- Validar la salida antes de escrituras posteriores.
- Reintentar solo los elementos cuya política de fallo lo permita.
No vuelvas a enviar un lote completo solo porque cinco elementos fallaron. Eso duplica el trabajo exitoso y el costo.
Límites que cambian el diseño de la solicitud
La referencia actual de la API de Anthropic permite hasta 100,000 solicitudes en un lote de mensajes, con valores únicos de custom_id de 1 a 64 caracteres compatibles. El límite de tamaño de solicitud de la API de lotes de primera parte es de 256 MB.
Varias opciones síncronas no son compatibles:
stream: verdaderospeed/ Modo rápidofallbacksdel lado del servidormax_tokens: 0en el procesamiento por lotes normal
Valida contra la documentación actual porque los límites y los parámetros compatibles pueden cambiar.
Manejar los rechazos por separado de los errores técnicos
Una negativa no es un error transitorio de infraestructura. Reintentar el mismo elemento indefinidamente desperdicia dinero y puede intentar evadir un límite de seguridad. Dependiendo del producto, ofrezca ayuda más segura, derive a revisión humana o utilice una política de respaldo documentada.
Una sobrecarga 529, una solicitud mal formada y una negativa requieren acciones diferentes. Almacena tanto el estado del elemento de alto nivel como el resultado detallado.
Combina Batch con el almacenamiento en caché de indicaciones de manera reflexiva
El contexto estable repetido—como un manual extenso de rúbricas o políticas—puede almacenarse en caché donde sea compatible. Batch aplica su descuento del 50% y el almacenamiento en caché utiliza sus propios multiplicadores. Mantén el prefijo estable y utiliza los campos de uso real para confirmar los ahorros.
No asuma que todos los elementos de un lote paralelo acceden a una caché que aún no se ha creado. Caliente o estructure el flujo de trabajo según el comportamiento de almacenamiento en caché documentado.
Patrón de control de calidad
Para trabajos de extracción:
- Usa salidas estructuradas o un esquema estricto cuando sea compatible.
- Incluye
source_idy los campos de evidencia. - Validar campos obligatorios y enumeraciones localmente.
- Ejemplos de salidas aceptadas para revisión humana.
- Enrutar registros con poca evidencia a una segunda revisión en lugar de adivinar.
Para evaluaciones:
- Ocultar la identidad del modelo cuando sea posible.
- Conservar las versiones del prompt y la rúbrica.
- Registrar esfuerzo, herramientas y tokens máximos.
- No compare los resultados de lotes con una ruta interactiva de velocidad premium sin señalar la diferencia.
Preguntas frecuentes
¿Cuánto tiempo tarda un lote de Claude?
Anthropic dice que los lotes pueden tardar hasta 24 horas. El tiempo real varía, por lo que no construyas promesas de latencia orientadas al usuario basadas en un promedio.
¿Se puede usar el modo rápido de Fable 5.2 en un lote?
No. El modo rápido optimiza la latencia de salida síncrona y no es compatible con Lotes de Mensajes.
¿Es Batch siempre más barato?
Las tarifas por token son más bajas, pero una validación deficiente, reintentos duplicados y el uso innecesario de Fable aún pueden generar desperdicio. Dirige el trabajo simple a granel a un modelo más barato cuando cumpla con el estándar de calidad.

















































































































