Clef API
La famille de modèles de décision open source Clef de Cloudflare : Clef (27B) et Clef Flash (9B) transforment des états et des questions typées en décisions probabilistes.
Clef Flash API
cloudflare/clef-flash
Clef Flash est le membre 9B rapide de la famille de modèles de décision open source Clef de Cloudflare, un fine-tune de Qwen3.5-9B servi sur Workers AI.
Clef API Contexte
Aperçu
Clef est la famille de modèles de décision open source de Cloudflare, proposée sur Cloudflare Workers AI. Elle transforme un état associé à un schéma de questions typées en décisions, en renvoyant une probabilité pour chaque option autorisée de chaque question en une seule passe avant. La famille comprend Clef, un modèle multimodal de 27B affiné à partir de Qwen3.8-27B, et Clef Flash, un modèle rapide de 9B affiné à partir de Qwen3.5-9B.
Historique de développement
Cloudflare a publié publiquement les modèles de décision Clef sous forme de modèles à poids ouverts (Apache-2.0). Clef est post-entraîné à partir de Qwen3.8-27B avec son encodeur visuel et une tête de schéma conjointe ; Clef Flash est la variante plus petite et plus rapide post-entraînée à partir de Qwen3.5-9B. Tous deux sont hébergés sur Cloudflare Workers AI.
Innovations clés
- Une seule passe avant renvoie une probabilité pour chaque option de chaque question
- La tête de schéma conjointe évalue conjointement toutes les options de toutes les questions
- Accepte du texte, du JSON et des images en entrée
- Aucune génération de texte libre ni aucun traitement d'analyse de la sortie
- Pleinement compatible avec les API de décision Jev et SystemOne
Clef API Spécifications techniques
Architecture
Clef utilise l'épine dorsale Qwen3.8-27B avec son encodeur visuel, stocké sous forme de safetensors fractionnés standard, ainsi qu'une tête de schéma conjointe qui lit les états cachés finaux du modèle de base, achemine les preuves depuis l'état vers chaque question et évalue toutes les options de manière conjointe. Clef Flash utilise l'épine dorsale plus petite Qwen3.5-9B.
Paramètres
Clef : 27B de paramètres. Clef Flash : 9B de paramètres.
Capacités
- Prise de décision multimodale sur du texte, du JSON et des images
- Types de questions : choix, score et vrai/faux (noul)
- Routage de flux de travail et sélection d'outils
- Classification et garde-fous
- Décisions structurées pilotées par schéma
Limitations
- Pas de génération de texte libre ; la sortie se limite aux décisions
- Clef est exécuté sur CPU/GPU via du code personnalisé ou Cloudflare Workers AI
Clef API Performance
Points forts
- Haute précision décisionnelle sur les benchmarks de classification, de récupération d'outils et de raisonnement
- Latence très faible
- Évaluation conjointe sur l'ensemble des questions et options
- Clef Flash est optimisé pour la vitesse
Efficacité en conditions réelles
Clef cible les flux de travail d'entreprise de bout en bout tels que le traitement des factures, le tri du service client, la classification des incidents de sécurité et l'observabilité des traces d'agents, où des décisions structurées, rapides et cohérentes sont essentielles.
Clef API Quand l'utiliser
Scénarios
- Vous avez besoin de décisions de routage ou de classification rapides et cohérentes sur du texte ou des images. La famille Clef API renvoie des probabilités calibrées pour chaque option au lieu de texte libre.
- Vous construisez des flux de travail agentiques qui doivent sélectionner des outils ou des garde-fous de manière fiable. Clef API évalue chaque option autorisée en une seule passe avant pour des décisions à faible latence.
- Vous traitez des documents d'entreprise tels que des factures et vous avez besoin de décisions structurées. Clef API associe directement un état et un schéma de questions typées à des probabilités.
Meilleures pratiques
- Définir chaque question avec un type clair (noul, choice ou score) et des critères explicites
- Garder l'état concentré sur la décision à prendre pour maximiser la précision
- Choisir Clef Flash lorsque la latence et le coût priment sur la précision maximale