Cloudflare: Clef
Cloudflare Clef ist ein multimodales Entscheidungsmodell mit 27 Milliarden Parametern für Klassifikation, Richtlinienprüfungen und Entscheidungen in Agenten-Workflows. Es bewertet einen bereitgestellten Zustand und typisierte Fragen und gibt Wahrscheinlichkeiten für zulässige Alternativen, ausgewählte Kategorien und gewichtete Scores zurück. Es akzeptiert textliche und visuelle Belege, ohne Prosa zu erzeugen.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Cloudflare Clef ist das größere dichte Modell der Clef-Entscheidungsfamilie, nachtrainiert auf Grundlage von Qwen3.8-27B mit dessen Vision-Encoder. Cloudflare kombiniert diese Grundarchitektur mit einem gemeinsamen Schemakopf, der Belege den Fragen zuordnet und deren zulässige Optionen zusammen bewertet. Clef liest eine Situation und gibt in einem einzigen Vorwärtsdurchlauf begrenzte Entscheidungen mit Wahrscheinlichkeiten zurück. Seine Ausgabe ist ein Klassifikationsergebnis statt generierter Prosa, eines offenen Berichts oder eines vorgeschlagenen Befehls.
Bereiten Sie Zustand und Fragenschema als getrennte Eingaben vor. Der Zustand kann eine Zeichenfolge oder JSON sein, das einen Datensatz, ein Gespräch, Dokumentinhalt oder eine Anwendungssituation repräsentiert. Fragen werden über stabile Namen identifiziert, und dieselben Namen kennzeichnen ihre zurückgegebenen Antworten. Definieren Sie, was jede Frage feststellen soll, und beschreiben Sie die relevanten Optionen. Ein Support-Datensatz kann fragen, welches Team die Anfrage bearbeiten soll, ob die Auswirkungen dringend sind und welches Schweregradkriterium zutrifft, ohne diese unterschiedlichen Entscheidungen in einer vagen Kategorie zusammenzufassen.
Eine noul-Frage gibt für eine binäre Bedingung die Wahrscheinlichkeit von wahr zurück. Eine choice-Frage gibt eine ausgewählte benannte Option, Wahrscheinlichkeiten je Option und Konfidenz zurück. Eine score-Frage verwendet eine geordnete Liste von Beschreibungen mit Indizes ab null und gibt einen Erwartungswert, eine Legende und Wahrscheinlichkeiten zurück. Ein Score mit Nachkommastellen ist sinnvoll, weil er Unsicherheit über geordnete Stufen zusammenfasst. Prüfen Sie neben der ausgewählten Antwort auch die Verteilung; zwei nahe beieinanderliegende Optionen können einen Unterschied sichtbar machen, den die Eingabe nicht klärt.
Nehmen Sie für Richtlinienprüfungen den tatsächlichen Regeltext und die Fakten des Datensatzes auf. Ein Beispiel ist ein Workflow zur Dokumentenverarbeitung mit Fragen dazu, ob der Datensatz vollständig ist, welche Prüfungskategorie zutrifft und wie stark die Belege für sofortige Aufmerksamkeit sprechen. Stellen Sie für getrennte Bedingungen getrennte Fragen. Eine Modellbewertung der Regelkonformität sollte mit der bereitgestellten Regel und den Belegen verbunden bleiben. Fehlt eine wichtige Bedingung, sollten Schema und Anwendung einen bewusst festgelegten Umgang mit dieser Unsicherheit vorsehen.
Stellen Sie für visuelle Belege ein lesbares Bild und eine Frage zu einem sichtbaren Zustand oder einer definierten Kategorie bereit. Eine Formularqualitätsprüfung könnte die Lesbarkeit bewerten, prüfen, ob ein erforderlicher Bereich vorhanden ist, und bestimmen, welche der bereitgestellten Qualitätsstufen das Formular am besten beschreibt. Die Schnittstelle des Herstellers für offene Gewichte akzeptiert auch Arrays von Videoeinzelbildern. Halten Sie die Einzelbilder in der richtigen Reihenfolge und benennen Sie das zu bewertende Ereignis. Ein begrenztes Entscheidungsschema kann dieses Material klassifizieren; eine erzählende Beschreibung oder beliebige neu generierte Felder gehören dagegen zu einer anderen Art von Ausgabe.
Die gehostete Herstellerreferenz nennt einen Kontext von 65.536 Tokens, eine bis 64 Fragen und bis zu vier eingebettete Bilder. PNG-, JPEG- oder WebP-Bilder sind jeweils auf 4 MiB und 16 Megapixel begrenzt, insgesamt auf 8 MiB dekodiert; der gesamte Anfragekörper ist auf 13 MiB begrenzt, und externe Bildlinks werden nicht akzeptiert. Das Eingabebudget umfasst Fragen und Medien. Langer Text kann passend gekürzt werden; bewahren Sie daher entscheidende Passagen und Quellenbezeichnungen. Diese Grenzen beschreiben die gehostete Bildschnittstelle des Herstellers; der Encoder mit offenen Gewichten hat eigene lokale Eingaberepräsentationen.
Cloudflares Veröffentlichung beschreibt ein Training für schemagebundene Bewertung und Wahrscheinlichkeitskalibrierung. Das Modell extrahiert relevante Belege für einzelne Optionen und berücksichtigt anschließend Informationen über mehrere Felder hinweg. Das kann Entscheidungen zu mehreren zusammenhängenden Fragen in einem Datensatz unterstützen, macht eine hohe Wahrscheinlichkeit aber nicht zur Garantie, dass der zugrunde liegende Sachverhalt wahr ist. Bewerten Sie schwierige, unvollständige und außerhalb der Kategorien liegende Datensätze ebenso wie eindeutige Fälle. Nützliche Entscheidungskriterien decken die Situationen ab, die der Workflow tatsächlich antrifft, und benennen wichtige Unterschiede ausdrücklich.
In einem Agenten-Workflow kann die Ausgabe bestimmen, welcher definierte nächste Schritt erwogen werden soll. Stellen Sie die aktuelle Beobachtung und mögliche Aktionen mit klaren Beschreibungen bereit und bewahren Sie anschließend die ausgewählte Option und ihre Wahrscheinlichkeiten. Die umgebende Anwendung wendet ihre Aktionsrichtlinie an und protokolliert, was sie getan hat. Halten Sie dieses Ausführungsprotokoll vom Entscheidungsergebnis getrennt: Die Auswahl eines Prüfwegs belegt nicht, dass ein Prüfer tätig wurde, und die Auswahl eines Diagnoseschritts belegt nicht, dass dieser Schritt erfolgreich war.
Das abschließende Artefakt ist das answers-Objekt zusammen mit dem Zustand und dem Schema, die es erzeugt haben. Verwenden Sie diese Datensätze, um unerwartete Klassifikationen zu untersuchen, mehrdeutige Kriterien zu identifizieren und Ergebnisse mit geprüften Aufgabenbeispielen zu vergleichen. Benötigt ein nachgelagerter Nutzer eine schriftliche Erklärung, können die Entscheidung und die ursprünglichen Belege als Eingaben für einen separaten Antwortschreibschritt dienen. Clef liefert die begrenzte probabilistische Entscheidung, die zur Auswahl dieser nächsten Stufe benötigt wird, mit einer klaren Darstellung dessen, was bewertet wurde.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefEinstieg
Cloudflare Clef ist ein multimodales Entscheidungsmodell mit 27 Milliarden Parametern für Klassifikation, Richtlinienprüfungen und Entscheidungen in Agenten-Workflows. Es bewertet einen bereitgestellten Zustand und typisierte Fragen und gibt Wahrscheinlichkeiten für zulässige Alternativen, ausgewählte Kategorien und gewichtete Scores zurück. Es akzeptiert textliche und visuelle Belege, ohne Prosa zu erzeugen.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- decisions
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · System One POST /v1/systemone
- Eingabe
text,image- Ausgabe
decisions- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits cloudflare/clef | Standard— |
Feldprovider | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Feldquestions | Typobject | AnforderungErforderlich | Werte und Limits | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldstate | Typschema | AnforderungErforderlich | Werte und Limits | Standard— |
Feldtrace | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldquestions.<id>.type | Typstring | AnforderungErforderlich | Werte und Limits noul, choice, score | Standard— |
Feldquestions.<id>.instructions | Typstring|object|array | AnforderungErforderlich | Werte und Limits | Standard— |
Feldquestions.<id>.criteria | Typobject|array | AnforderungOptional | Werte und Limits Bedingungen: choice/score: erforderlich; noul: optional. criteria bei choice ist ein Objekt; score ist ein Array mit minItems1. | Standard— |
Feldquestions.<id>.criteria.true | Typstring|object|array | AnforderungErforderlich | Werte und Limits Gilt, wenn: Kriterienobjekt noul bereitgestellt | Standard— |
Feldquestions.<id>.criteria.false | Typstring|object|array | AnforderungErforderlich | Werte und Limits Gilt, wenn: Kriterienobjekt noul bereitgestellt | Standard— |
Kombinationen von Eingabematerialien
noul · Erforderlich: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Erforderlich: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Erforderlich: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, state, questions |
Parametermaterial_types | Vertragtext, image |
Parameteroptional_controls | Vertragprovider, session_id, trace, user |
Parametermultimodal_input_binding | VertragVerwenden Sie ausschließlich die exakt deklarierte Zustands-/Dokumentdarstellung. Die Bildfunktion des Herstellers allein belegt keinen modellspezifisch akzeptierten Übertragungsweg für Bilder. |
Lebenszyklus: synchronous
Senden Sie die exakte Modell-ID und bewahren Sie die vollständige native Antwort auf.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Kontexttoken, mehr als | Kontexttoken, bis einschließlich | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Kontexttoken, mehr als— | Kontexttoken, bis einschließlichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00048 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationAnfragelängenstufe 1 | Tarifstaffel— | Kontexttoken, mehr als0 | Kontexttoken, bis einschließlichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00048 / 1K Tokens Ausgabe · Ausgabetoken $0 / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · System One
{
"model": "cloudflare/clef",
"questions": {
"is_bug": {
"criteria": {
"false": "The customer is asking a question or requesting a feature.",
"true": "The customer describes broken or unexpected product behavior."
},
"instructions": "Is the customer reporting a software defect?",
"type": "noul"
},
"team": {
"criteria": {
"account": "Login, permissions, or profile issues.",
"frontend": "Rendering, layout, or browser compatibility issues.",
"payments": "Checkout, billing, or payment processing issues."
},
"instructions": "Which team should own this ticket?",
"type": "choice"
},
"urgency": {
"criteria": [
"Can wait for the next release",
"Should be fixed this week",
"Blocking revenue right now"
],
"instructions": "How urgent is this ticket?",
"type": "score"
}
},
"state": {
"customer_tier": "enterprise",
"ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
}
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='cloudflare/clef'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · System One
json
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Jede gelieferte Antwort mit Frage-ID bleibt mit ihrem genauen Typ, dem noul/choice/score-Wert, der Konfidenz, den Wahrscheinlichkeiten und der Legende erhalten. Das gesamte ursprüngliche JSON wird gespeichert und erst nach der Abrechnung zurückgegeben.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie den ursprünglichen Vorgang und die vollständige oder teilweise Antwort auf; wiederholen Sie POST nicht.
Antwortfelder
| Feld | Typ |
|---|---|
Feldmodel | Typstring |
Feldid | Typstring |
Feldprovider | Typstring |
Feldanswers.<id>.type | Typstring |
Feldanswers.<id>.noul | Typnumber |
Feldanswers.<id>.choice | Typstring |
Feldanswers.<id>.score | Typnumber |
Feldanswers.<id>.confidence | Typnumber |
Feldanswers.<id>.probabilities | Typobject |
Feldanswers.<id>.legend | Typobject |
Feldusage.input_tokens | Typinteger |
Feldusage.output_tokens | Typinteger |
Feldusage.cost | Typnumber |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungUngültiges Pflichtfeld, ungültige Darstellung oder ungültiger Wert | Nächster SchrittKorrigieren Sie das angegebene Anfragefeld. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra cloudflare/clef
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Cloudflare: Clef
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Welche Felder verwendet die Anfrage?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user