Cloudflare: Clef
Cloudflare Clef ist ein multimodales Entscheidungsmodell mit 27B Parametern für Klassifizierung, Richtlinienprüfungen und Entscheidungen in Agenten-Workflows. Es bewertet einen bereitgestellten Zustand und typisierte Fragen und liefert Wahrscheinlichkeiten für zulässige Alternativen, ausgewählte Kategorien und gewichtete Scores. Es akzeptiert textuelle und visuelle Belege, ohne Prosa zu generieren.
Ü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 und per Post-Training aus Qwen3.8-27B mit dessen Vision-Encoder entstanden. Cloudflare kombiniert dieses Backbone mit einem gemeinsamen Schema-Kopf, der Belege den Fragen zuordnet und deren zulässige Optionen gemeinsam bewertet. Clef liest eine Situation und liefert in einem einzigen Vorwärtsdurchlauf eingegrenzte Entscheidungen mit Wahrscheinlichkeiten. Seine Ausgabe ist ein Klassifizierungsergebnis statt generierter Prosa, eines offenen Berichts oder eines vorgeschlagenen Befehls.
Bereiten Sie den Zustand und das Fragenschema als getrennte Eingaben vor. Der Zustand kann eine Zeichenkette oder JSON sein und einen Datensatz, eine Konversation, Dokumentinhalte oder eine Anwendungssituation darstellen. Fragen werden mit stabilen Namen als Schlüssel angelegt, und dieselben Namen kennzeichnen die zurückgegebenen Antworten. Legen Sie fest, was jede Frage klären soll, und beschreiben Sie die relevanten Optionen. Ein Support-Datensatz kann fragen, welches Team die Anfrage bearbeiten soll, ob die Auswirkung dringend ist und welches Schweregradkriterium zutrifft, ohne diese unterschiedlichen Entscheidungen zu einer vagen Kategorie zusammenzufassen.
Eine „noul“-Frage liefert die Wahrscheinlichkeit für „wahr“ bei einer binären Bedingung. Eine „choice“-Frage liefert eine ausgewählte benannte Option, Wahrscheinlichkeiten pro Option und eine Konfidenz. Eine „score“-Frage verwendet eine geordnete Liste von Beschreibungen mit einem Index ab null und liefert einen erwarteten Score, eine Legende und Wahrscheinlichkeiten. Ein Bruchwert als Score ist aussagekräftig, weil er die Unsicherheit über geordnete Stufen zusammenfasst. Prüfen Sie neben der ausgewählten Antwort auch die Verteilung; zwei nah beieinanderliegende Optionen können eine Unterscheidung offenlegen, die die Eingabe nicht klärt.
Für Richtlinienprüfungen nehmen Sie den tatsächlichen Regeltext und die Fakten des Datensatzes auf. Ein Beispiel ist ein Workflow zur Dokumentverarbeitung mit Fragen danach, ob der Datensatz vollständig ist, welche Prüfkategorie zutrifft und wie stark die Belege eine sofortige Beachtung stützen. Stellen Sie für getrennte Bedingungen getrennte Fragen. Eine Modelleinschätzung der Regelkonformität sollte mit der bereitgestellten Regel und den Belegen verknüpft bleiben. Fehlt eine wichtige Bedingung, sollten Schema und Anwendung einen bewussten Weg haben, mit dieser Unsicherheit umzugehen.
Für visuelle Belege stellen Sie ein lesbares Bild und eine Frage zu einem sichtbaren Zustand oder einer definierten Kategorie bereit. Eine Prüfung der Formularqualität kann die Lesbarkeit bewerten, ob ein erforderlicher Bereich vorhanden ist und welche der bereitgestellten Qualitätsstufen ihn am besten beschreibt. Die Open-Weight-Schnittstelle des Herstellers akzeptiert außerdem Arrays von Videoeinzelbildern. Halten Sie die Einzelbilder in ihrer Reihenfolge und benennen Sie das zu bewertende Ereignis. Ein eingegrenztes Entscheidungsschema kann dieses Material klassifizieren, während eine Anfrage nach einer erzählenden Beschreibung oder nach beliebigen neu generierten Feldern zu einer anderen Art von Ausgabe gehört.
Die gehostete Referenz des Herstellers nennt einen Kontext von 65.536 Token, ein bis 64 Fragen und bis zu vier eingebettete Bilder. PNG-, JPEG- oder WebP-Bilder sind auf jeweils 4 MiB und 16 Megapixel begrenzt, bei insgesamt 8 MiB nach der Dekodierung; der gesamte Request-Body ist auf 13 MiB begrenzt, und Remote-Bildlinks werden nicht akzeptiert. Das Eingabebudget umfasst die Fragen und die Medien. Langer Text kann gekürzt werden, damit er passt; bewahren Sie daher entscheidende Passagen und Quellenangaben. Diese Grenzen beschreiben die gehostete Bildschnittstelle des Herstellers; der Open-Weight-Encoder hat eigene Darstellungen für lokale Eingaben.
Cloudflares Veröffentlichung beschreibt ein Training für schemagebundene Bewertung und die Kalibrierung von Wahrscheinlichkeiten. Das Modell extrahiert relevante Belege für einzelne Optionen und berücksichtigt anschließend Informationen über mehrere Felder hinweg. Das kann Entscheidungen über mehrere zusammenhängende Fragen in einem Datensatz unterstützen, macht eine hohe Wahrscheinlichkeit aber nicht zur Garantie dafür, dass die zugrunde liegende Tatsache zutrifft. Bewerten Sie neben einfachen Fällen auch schwierige, unvollständige und nicht in die Kategorien passende Datensätze. Nützliche Entscheidungskriterien decken die Situationen ab, denen der Workflow tatsächlich begegnet, und machen wichtige Unterscheidungen explizit.
In einem Agenten-Workflow kann die Ausgabe bestimmen, welcher definierte nächste Schritt in Betracht kommt. Liefern Sie die aktuelle Beobachtung und mögliche Aktionen mit klaren Beschreibungen und bewahren Sie anschließend die ausgewählte Option und ihre Wahrscheinlichkeiten auf. 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 der Schritt erfolgreich war.
Das endgültige Artefakt ist das Antwortobjekt zusammen mit dem Zustand und dem Schema, aus denen es hervorgegangen ist. Nutzen Sie diese Aufzeichnungen, um unerwartete Klassifizierungen zu untersuchen, mehrdeutige Kriterien zu erkennen und Ergebnisse mit geprüften Aufgabenbeispielen zu vergleichen. Benötigt ein nachgelagerter Nutzer eine schriftliche Erklärung, können Entscheidung und ursprüngliche Belege als Eingaben für einen separaten Schritt zur Antworterstellung dienen. Clef liefert die eingegrenzte probabilistische Entscheidung, die nötig ist, um diese nächste Stufe mit einer klaren Darstellung dessen zu wählen, was bewertet wurde.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefStart
Cloudflare Clef ist ein multimodales Entscheidungsmodell mit 27B Parametern für Klassifizierung, Richtlinienprüfungen und Entscheidungen in Agenten-Workflows. Es bewertet einen bereitgestellten Zustand und typisierte Fragen und liefert Wahrscheinlichkeiten für zulässige Alternativen, ausgewählte Kategorien und gewichtete Scores. Es akzeptiert textuelle und visuelle Belege, ohne Prosa zu generieren.
- Zulässige Eingaben
- Text · Bilder
- Ergebnisse
- decisions
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · System One POST /v1/systemone
- Eingabetypen
text,image- Ausgabetypen
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. Bei choice ist criteria ein Objekt; bei score ist es ein Array mit minItems=1. | 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 Bildfähigkeit des Herstellers allein belegt kein modellspezifisch akzeptiertes Bildtransportformat. |
Lebenszyklus: synchronous
Senden Sie die genaue 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 Token Ausgabe · Ausgabetoken $0 / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
| KonfigurationAnfragelängenstufe 1 | Tarifstaffel— | Kontexttoken, mehr als0 | Kontexttoken, bis einschließlichKeine Obergrenze | Gebühr Eingabe · Eingabetoken $0.00048 / 1K Token Ausgabe · Ausgabetoken $0 / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
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 bereitgestellte Antwort mit Fragen-ID bleibt mit ihrem genauen Typ, ihrem noul/choice/score-Wert, ihrer Konfidenz, ihren Wahrscheinlichkeiten und ihrer 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 sowie 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