Cloudflare: Clef
Cloudflare Clef is een multimodaal beslismodel met 27 miljard parameters voor classificatie, beleidscontroles en keuzes in agentworkflows. Het beoordeelt een aangeleverde toestand en getypeerde vragen en retourneert waarschijnlijkheden voor toegestane alternatieven, geselecteerde categorieën en gewogen scores. Het accepteert tekstueel en visueel bewijsmateriaal zonder tekst te genereren.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Cloudflare Clef is het grotere dense model in de Clef-familie van beslismodellen, verder getraind op basis van Qwen3.8-27B met zijn vision-encoder. Cloudflare combineert die basisarchitectuur met een gezamenlijke schemahead die bewijsmateriaal aan de vragen toewijst en hun toegestane opties gezamenlijk beoordeelt. Clef leest een situatie en retourneert in één voorwaartse doorgang begrensde beslissingen met waarschijnlijkheden. De uitvoer is een classificatieresultaat, in plaats van gegenereerde tekst, een open rapport of een voorgestelde opdracht.
Bereid de toestand en het vraagschema als afzonderlijke invoer voor. De toestand kan een tekenreeks of JSON zijn die een record, gesprek, documentinhoud of toepassingssituatie weergeeft. Vragen worden aangeduid met stabiele namen en dezelfde namen identificeren de geretourneerde antwoorden. Definieer wat elke vraag moet vaststellen en beschrijf de relevante opties. Een supportrecord kan vragen welk team de aanvraag moet behandelen, of de impact dringend is en welk ernstcriterium van toepassing is, zonder die verschillende beslissingen in één vage categorie samen te voegen.
Een noul-vraag retourneert voor een binaire voorwaarde de waarschijnlijkheid van waar. Een choice-vraag retourneert een geselecteerde benoemde optie, waarschijnlijkheden per optie en confidence. Een score-vraag gebruikt een geordende lijst beschrijvingen met indices vanaf nul en retourneert een verwachte score, een legenda en waarschijnlijkheden. Een score met decimalen is zinvol omdat hij onzekerheid over geordende niveaus samenvat. Bekijk zowel de verdeling als het geselecteerde antwoord; twee opties die dicht bij elkaar liggen kunnen een onderscheid blootleggen dat de invoer niet oplost.
Neem voor beleidscontroles de werkelijke regeltekst en de feiten van het record op. Een voorbeeld is een workflow voor documentverwerking met vragen of het record volledig is, welke beoordelingscategorie van toepassing is en hoe sterk het bewijsmateriaal onmiddellijke aandacht ondersteunt. Stel afzonderlijke vragen voor afzonderlijke voorwaarden. Een modelbeoordeling van naleving moet verbonden blijven met de aangeleverde regel en het bewijsmateriaal. Als een belangrijke voorwaarde ontbreekt, moeten het schema en de toepassing een bewuste manier hebben om met die onzekerheid om te gaan.
Lever voor visueel bewijsmateriaal een leesbare afbeelding aan en een vraag over een zichtbare toestand of een gedefinieerde categorie. Een controle op formulierkwaliteit kan de leesbaarheid beoordelen, nagaan of een verplicht gebied aanwezig is en bepalen welk van de aangeleverde kwaliteitsniveaus het formulier het best beschrijft. De interface van de maker voor open gewichten accepteert ook arrays van videoframes. Houd de frames in de juiste volgorde en benoem de te beoordelen gebeurtenis. Een begrensd beslisschema kan dat materiaal classificeren, terwijl een verzoek om een verhalende beschrijving of willekeurige nieuw gegenereerde velden bij een ander soort uitvoer hoort.
De gehoste referentie van de fabrikant vermeldt een context van 65.536 tokens, één tot 64 vragen en maximaal vier ingebedde afbeeldingen. PNG-, JPEG- en WebP-afbeeldingen zijn elk beperkt tot 4 MiB en 16 megapixels, met in totaal 8 MiB gedecodeerd; de volledige aanvraagbody is beperkt tot 13 MiB en externe afbeeldingslinks worden niet geaccepteerd. Het invoerbudget omvat de vragen en media. Lange tekst kan worden afgekapt om te passen, dus behoud beslissende passages en bronlabels. Deze limieten beschrijven de gehoste afbeeldingsinterface van de producent; de encoder met open gewichten heeft eigen representaties voor lokale invoer.
Cloudflares publicatie beschrijft training voor schemagebonden beoordeling en kalibratie van waarschijnlijkheden. Het model haalt relevant bewijsmateriaal voor afzonderlijke opties op en neemt vervolgens informatie uit meerdere velden in beschouwing. Dat kan beslissingen over verschillende samenhangende vragen binnen één record ondersteunen, maar maakt een hoge waarschijnlijkheid niet tot een garantie dat het onderliggende feit waar is. Beoordeel moeilijke, onvolledige en buiten de categorieën vallende records naast eenvoudige gevallen. Nuttige besliscriteria dekken de situaties die de workflow daadwerkelijk tegenkomt en maken belangrijke verschillen expliciet.
In een agentworkflow kan de uitvoer bepalen welke gedefinieerde volgende stap moet worden overwogen. Lever de huidige waarneming en mogelijke acties aan met duidelijke beschrijvingen en bewaar vervolgens de geselecteerde optie en de bijbehorende waarschijnlijkheden. De omringende toepassing past haar actiebeleid toe en legt vast wat zij heeft gedaan. Houd dat uitvoeringsrecord gescheiden van het beslisresultaat: de keuze voor een beoordelingsroute stelt niet vast dat een beoordelaar heeft gehandeld en de keuze voor een diagnostische stap stelt niet vast dat die stap is geslaagd.
Het uiteindelijke artefact is het answers-object samen met de toestand en het schema die het hebben voortgebracht. Gebruik die records om onverwachte classificaties te onderzoeken, dubbelzinnige criteria te identificeren en resultaten te vergelijken met beoordeelde taakvoorbeelden. Als een gebruiker verderop in het proces een schriftelijke uitleg nodig heeft, kunnen de beslissing en het oorspronkelijke bewijsmateriaal als invoer dienen voor een afzonderlijke stap die een antwoord schrijft. Clef levert de begrensde probabilistische beslissing die nodig is om die volgende fase te kiezen, met een duidelijke vastlegging van wat is beoordeeld.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clefAan de slag
Cloudflare Clef is een multimodaal beslismodel met 27 miljard parameters voor classificatie, beleidscontroles en keuzes in agentworkflows. Het beoordeelt een aangeleverde toestand en getypeerde vragen en retourneert waarschijnlijkheden voor toegestane alternatieven, geselecteerde categorieën en gewogen scores. Het accepteert tekstueel en visueel bewijsmateriaal zonder tekst te genereren.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- decisions
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · System One POST /v1/systemone
- Invoer
text,image- Uitvoer
decisions- Uitvoerformaat
- json
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten cloudflare/clef | Standaard— |
Veldprovider | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquestions | Typeobject | VereisteVereist | Waarden en limieten | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldstate | Typeschema | VereisteVereist | Waarden en limieten | Standaard— |
Veldtrace | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquestions.<id>.type | Typestring | VereisteVereist | Waarden en limieten noul, choice, score | Standaard— |
Veldquestions.<id>.instructions | Typestring|object|array | VereisteVereist | Waarden en limieten | Standaard— |
Veldquestions.<id>.criteria | Typeobject|array | VereisteOptioneel | Waarden en limieten Voorwaarden: choice/score: verplicht; noul: optioneel. Bij choice is criteria een object; bij score een array met minItems1. | Standaard— |
Veldquestions.<id>.criteria.true | Typestring|object|array | VereisteVereist | Waarden en limieten Geldt wanneer: noul-criteriaobject opgegeven | Standaard— |
Veldquestions.<id>.criteria.false | Typestring|object|array | VereisteVereist | Waarden en limieten Geldt wanneer: noul-criteriaobject opgegeven | Standaard— |
Combinaties van invoermaterialen
noul · Vereist: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Vereist: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Vereist: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, state, questions |
Parametermaterial_types | Contracttext, image |
Parameteroptional_controls | Contractprovider, session_id, trace, user |
Parametermultimodal_input_binding | ContractGebruik uitsluitend de exact gedeclareerde weergave van status/document. Ondersteuning voor afbeeldingen door de fabrikant alleen bewijst niet dat een modelspecifieke aanlevervorm voor afbeeldingen wordt geaccepteerd. |
Levenscyclus: synchronous
Verstuur de exacte model-ID en bewaar het volledige natieve antwoord.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Contexttokens, meer dan | Contexttokens, tot en met | Kosten |
|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Contexttokens, meer dan— | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.00048 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieAanvraaglengte · niveau 1 | Tariefstaffel— | Contexttokens, meer dan0 | Contexttokens, tot en metGeen bovengrens | Kosten Invoer · Invoertokens $0.00048 / 1K tokens Uitvoer · Uitvoertokens $0 / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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
Resultaten ophalen en opslaan
Ailoot Ultra · System One
json
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Elk aangeleverd antwoord per vraag-ID blijft behouden, met het exacte type, de waarde voor noul/choice/score, de betrouwbaarheid, kansen en legenda. De volledige oorspronkelijke JSON wordt opgeslagen en pas na de afrekening teruggestuurd.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; voer POST niet opnieuw uit.
Antwoordvelden
| Veld | Type |
|---|---|
Veldmodel | Typestring |
Veldid | Typestring |
Veldprovider | Typestring |
Veldanswers.<id>.type | Typestring |
Veldanswers.<id>.noul | Typenumber |
Veldanswers.<id>.choice | Typestring |
Veldanswers.<id>.score | Typenumber |
Veldanswers.<id>.confidence | Typenumber |
Veldanswers.<id>.probabilities | Typeobject |
Veldanswers.<id>.legend | Typeobject |
Veldusage.input_tokens | Typeinteger |
Veldusage.output_tokens | Typeinteger |
Veldusage.cost | Typenumber |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeOngeldig verplicht veld, ongeldige weergave of ongeldige waarde | Volgende stapCorrigeer het aangegeven aanvraagveld. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra cloudflare/clef
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Cloudflare: Clef
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/systemone·cloudflare/clef:text,image→decisions- Welke velden gebruikt het verzoek?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user