Clef API
La familia de modelos de decisión de código abierto Clef de Cloudflare: Clef (27B) y Clef Flash (9B) convierten estados y preguntas tipadas en decisiones probabilísticas.
Clef API
cloudflare/clef
Cloudflare Clef es un modelo de decisión multimodal de 27B que convierte texto, JSON, imágenes o video en respuestas JSON estructuradas basadas en probabilidades.
Clef API Antecedentes
Resumen
Clef es la familia de modelos de decisión de código abierto de Cloudflare, servida en Cloudflare Workers AI. Convierte un estado más un esquema de preguntas tipadas en decisiones, devolviendo una probabilidad para cada opción permitida de cada pregunta en una sola pasada hacia adelante (forward pass). La familia incluye Clef, un modelo multimodal de 27B ajustado a partir de Qwen3.8-27B, y Clef Flash, un modelo rápido de 9B ajustado a partir de Qwen3.5-9B.
Historia de Desarrollo
Cloudflare lanzó públicamente los modelos de decisión Clef como modelos de pesos abiertos (Apache-2.0). Clef está posentrenado a partir de Qwen3.8-27B con su codificador de visión más un cabezal de esquema conjunto; Clef Flash es la variante más pequeña y rápida posentrenada a partir de Qwen3.5-9B. Ambos se sirven en Cloudflare Workers AI.
Innovaciones Clave
- Una sola pasada hacia adelante (forward pass) devuelve una probabilidad para cada opción de cada pregunta
- El cabezal de esquema conjunto puntúa todas las opciones de todas las preguntas de manera conjunta
- Acepta texto, JSON e imágenes como entrada
- Sin generación de texto en formato libre ni necesidad de procesamiento de salida
- Totalmente compatible con las API de decisión Jev y SystemOne
Clef API Especificaciones Técnicas
Arquitectura
Clef utiliza el modelo base Qwen3.8-27B con su codificador de visión, almacenado como safetensors fragmentados estándar, más un cabezal de esquema conjunto que lee los estados ocultos finales del modelo base, enruta la evidencia del estado a cada pregunta y puntúa todas las opciones conjuntamente. Clef Flash utiliza el modelo base más pequeño Qwen3.5-9B.
Parámetros
Clef: 27B parámetros. Clef Flash: 9B parámetros.
Capacidades
- Toma de decisiones multimodal sobre texto, JSON e imágenes
- Tipos de preguntas de opción, puntuación y verdadero/falso (noul)
- Enrutamiento de flujos de trabajo y selección de herramientas
- Clasificación y barreras de seguridad (guardrails)
- Decisiones estructuradas impulsadas por esquemas
Limitaciones
- Sin generación de texto libre; la salida consiste únicamente en decisiones
- Clef se sirve mediante CPU/GPU a través de código personalizado o Cloudflare Workers AI
Clef API Rendimiento
Fortalezas
- Alta precisión de decisión en evaluaciones comparativas de clasificación, recuperación de herramientas y razonamiento
- Latencia muy baja
- Puntuación conjunta en todas las preguntas y opciones
- Clef Flash está optimizado para ofrecer mayor velocidad
Efectividad en el Mundo Real
Clef se enfoca en flujos de trabajo empresariales integrales, como el procesamiento de facturas, la clasificación de atención al cliente, la clasificación de incidentes de seguridad y la observabilidad de trazas de agentes, donde las decisiones estructuradas rápidas y coherentes son esenciales.
Clef API Cuándo Usar
Escenarios
- Necesita decisiones de clasificación o enrutamiento rápidas y coherentes sobre texto o imágenes. La familia Clef API devuelve probabilidades calibradas para cada opción en lugar de texto libre.
- Está creando flujos de trabajo de agentes que deben seleccionar herramientas o barreras de seguridad de manera confiable. Clef API puntúa cada opción permitida en una sola pasada para la toma de decisiones con baja latencia.
- Procesa documentos comerciales como facturas y necesita decisiones estructuradas. Clef API asigna directamente un estado y un esquema de preguntas tipadas a probabilidades.
Mejores Prácticas
- Defina cada pregunta con un tipo claro (noul, opción o puntuación) y criterios explícitos
- Mantenga el estado centrado en la decisión en cuestión para maximizar la precisión
- Elija Clef Flash cuando la latencia y el costo sean más importantes que la máxima precisión