Clef API
Cloudflares Open-Source-Entscheidungsmodellfamilie Clef: Clef (27B) und Clef Flash (9B) verwandeln Zustände und typisierte Fragen in probabilistische Entscheidungen.
Clef API
cloudflare/clef
Cloudflare Clef ist ein multimodales 27B-Entscheidungsmodell, das Text, JSON, Bilder oder Videos in strukturierte, wahrscheinlichkeitsbasierte JSON-Antworten umwandelt.
Clef API Hintergrund
Überblick
Clef ist die Open-Source-Entscheidungsmodellfamilie von Cloudflare, die über Cloudflare Workers AI bereitgestellt wird. Sie verwandelt einen Zustand plus ein Schema typisierter Fragen in Entscheidungen und gibt in einem einzigen Forward-Pass eine Wahrscheinlichkeit für jede zulässige Option jeder Frage zurück. Die Familie umfasst Clef, ein multimodales 27B-Modell, das auf Basis von Qwen3.8-27B feingetunt wurde, und Clef Flash, ein schnelles 9B-Modell, das auf Basis von Qwen3.5-9B feingetunt wurde.
Entwicklungsgeschichte
Cloudflare hat die Clef-Entscheidungsmodelle öffentlich als Open-Weight-Modelle (Apache-2.0) veröffentlicht. Clef ist ein aus Qwen3.8-27B nachgeschultes Modell mit Vision-Encoder und einem Joint-Schema-Head; Clef Flash ist die kleinere, schnellere Variante, die aus Qwen3.5-9B nachgeschult wurde. Beide werden auf Cloudflare Workers AI bereitgestellt.
Wichtige Innovationen
- Ein einziger Forward-Pass liefert eine Wahrscheinlichkeit für jede Option jeder Frage
- Joint-Schema-Head bewertet alle Optionen aller Fragen gemeinsam
- Akzeptiert Text, JSON und Bilder als Eingabe
- Keine Freitextgenerierung und kein Output-Parsing erforderlich
- Vollständig kompatibel mit den Jev- und SystemOne-Entscheidungs-APIs
Clef API Technische Spezifikationen
Architektur
Clef nutzt das Qwen3.8-27B-Backbone mit dessen Vision-Encoder, gespeichert als standardmäßige geshardete Safetensors, sowie einen Joint-Schema-Head, der die finalen Hidden States des Backbones liest, Evidenz aus dem Zustand an jede Frage leitet und alle Optionen gemeinsam bewertet. Clef Flash nutzt das kleinere Qwen3.5-9B-Backbone.
Parameter
Clef: 27B Parameter. Clef Flash: 9B Parameter.
Funktionen
- Multimodale Entscheidungsfindung über Text, JSON und Bilder
- Fragetypen für Auswahl (Choice), Bewertung (Score) und Wahr/Falsch (Noul)
- Workflow-Routing und Tool-Auswahl
- Klassifizierung und Guardrails
- Strukturierte, schemabasierte Entscheidungen
Einschränkungen
- Keine Freitextgenerierung; Ausgabe besteht ausschließlich aus Entscheidungen
- Clef wird über benutzerdefinierten Code oder Cloudflare Workers AI via CPU/GPU bereitgestellt
Clef API Leistung
Stärken
- Hohe Entscheidungsgenauigkeit über Klassifizierungs-, Tool-Retrieval- und Reasoning-Benchmarks hinweg
- Sehr geringe Latenz
- Gemeinsame Bewertung über alle Fragen und Optionen hinweg
- Clef Flash ist auf Geschwindigkeit optimiert
Praxiseffektivität
Clef zielt auf Ende-zu-Ende-Geschäftsworkflows ab, wie die Rechnungsverarbeitung, Triage im Kundenservice, Klassifizierung von Sicherheitsvorfällen und Beobachtbarkeit von Agenten-Traces, bei denen schnelle und konsistente strukturierte Entscheidungen entscheidend sind.
Clef API Wann verwenden
Szenarien
- Sie benötigen schnelle, konsistente Routing- oder Klassifizierungsentscheidungen über Text oder Bilder. Die Clef-API-Familie liefert kalibrierte Wahrscheinlichkeiten für jede Option anstelle von Freitext.
- Sie entwickeln agentische Workflows, die Werkzeuge oder Guardrails zuverlässig auswählen müssen. Die Clef API bewertet jede zulässige Option in einem einzigen Forward-Pass für Entscheidungen mit geringer Latenz.
- Sie verarbeiten Geschäftsdokumente wie Rechnungen und benötigen strukturierte Entscheidungen. Die Clef API bildet einen Zustand und ein Schema typisierter Fragen direkt auf Wahrscheinlichkeiten ab.
Best Practices
- Definieren Sie jede Frage mit einem klaren Typ (Noul, Choice oder Score) und expliziten Kriterien
- Halten Sie den Zustand auf die jeweilige Entscheidung fokussiert, um die Genauigkeit zu maximieren
- Wählen Sie Clef Flash, wenn Latenz und Kosten wichtiger sind als maximale Genauigkeit