Clef a Clef-Flash – multimodální rozhodovací modely Cloudflare

Vytvořeno: 20.10.2026 | Aktualizováno: 20.10.2026 15:33

Clef a Clef-Flash jsou otevřené modely pro strukturované rozhodování. Model nedopisuje volný text. Dostane stav a předem popsané otázky a vrací uzavřené odpovědi s pravděpodobnostmi jednotlivých voleb.

Cloudflare je provozuje ve Workers AI jako modely @cf/cloudflare/clef a @cf/cloudflare/clef-flash. Stejné váhy jsou dostupné také na Hugging Face pod licencí Apache-2.0.

Clef řeší situace, kdy aplikace potřebuje vybrat odpověď z omezené množiny a výsledek má přímo zpracovat kód. Příkladem je směrování požadavku zákazníka, klasifikace incidentu, vyhodnocení pravidla nebo výběr dalšího kroku ve workflow.

Vstup tvoří state a sada otázek. Model podporuje tři typy otázek:

choice vybírá jednu možnost z předem dané množiny a vrací pravděpodobnosti voleb.
score hodnotí stav na předem vymezené škále.
noul vyjadřuje míru platnosti tvrzení hodnotou v rozsahu 0 až 1.

Výstup není volně formulovaná věta. Aplikace proto nemusí odpověď dodatečně parsovat a může podle pravděpodobnosti nastavit práh, fallback nebo předat nejistý případ člověku.

Vlastnost	Clef	Clef-Flash
Parametry	27B	9B
Základní model	Qwen/Qwen3.8-27B	Qwen/Qwen3.5-9B
Účel	strukturované rozhodování	stejný účel; menší a rychlejší varianta
Licence	Apache-2.0	Apache-2.0
Volný text	negeneruje	negeneruje

Model card Clefu jej popisuje jako post-trénovanou variantu Qwen/Qwen3.8-27B. Model card Clef-Flash uvádí základ Qwen/Qwen3.5-9B. Dokumentace neuvádí srovnávací benchmark rychlosti, ceny ani přesnosti mezi oběma variantami; označení „rychlejší“ proto neříká, o kolik.

state může obsahovat text nebo strukturovaný JSON. Upstream model card dále uvádí podporu obrazů a videa předaného jako pole snímků.

Hostované rozhraní Workers AI dokumentuje přímo obrazový vstup. Přijímá vložené obrázky PNG, JPEG a WebP; URL obrázku nepřijímá. Dokumentace Workers AI na této stránce video výslovně nepopisuje, proto z podpory upstream vah nelze bez dalšího vyvozovat dostupnost videa v hostované službě Cloudflare.

Limit	Hodnota	Význam
Kontextové okno	65 536 tokenů	Zahrnuje otázky i média. Po překročení Workers AI request odmítne.
Otázky v requestu	1 až 64	Každá otázka má vlastní identifikátor a odpověď.
Identifikátor otázky	nejvýše 100 znaků	Povolená jsou písmena, číslice, `_`, `.` a `-`.
Obrázky	nejvýše 4	Jen vložená binární data, nikoli vzdálené URL.
Jeden obrázek	nejvýše 4 MiB a 16 megapixelů
Dekódované obrázky celkem	nejvýše 8 MiB
Celé HTTP tělo	nejvýše 13 MiB
Jeden obrázek v kontextu	nejvýše 1 024 tokenů

Dlouhý textový state Workers AI zkrátí tak, aby se vešel do tokenového limitu. Dokumentace modelu dále popisuje převod obrazu na tokeny: obraz se zarovnává na bloky 32 × 32 pixelů, každý blok odpovídá jednomu tokenu a přidají se tři značky.

Workers AI uvádí pro hostovaný Clef kontextové okno 65 536 tokenů. Upstream README pro lokální API uvádí u parametru max_length výchozí hodnotu 16 384 tokenů a parametr max_state_tokens pro omezení délky vstupu.

Tyto údaje nelze sloučit do jediného univerzálního limitu. První je limit hostovaného rozhraní Cloudflare, druhý je výchozí parametr lokálního API. Při lokálním provozu je proto nutné ověřit platný limit v použité verzi knihovny; při volání Workers AI platí limit uvedený v její dokumentaci.

Cloudflare u Clefu uvádí cenu 0,24 USD za milion vstupních tokenů. Výstupní tokeny se neúčtují; obrázky se přepočítají na vstupní tokeny a účtují se stejnou sazbou.

Workers AI poskytuje denně 10 000 neuronů zdarma, s resetem v 00:00 UTC. Workers Paid účtuje spotřebu nad tuto kvótu sazbou 0,011 USD za 1 000 neuronů. Po vyčerpání kvóty na Workers Free požadavky selžou.

Cloudflare na kontrolovaných stránkách neuvádí převod mezi neurony a tokeny Clefu. Z denní kvóty proto nelze korektně spočítat počet requestů. Dokumentace také neuvádí limit requestů za minutu přímo pro Clef; obecné limity podle kategorií úloh nelze bez výslovného přiřazení přenést na tento model.

Jev a Clef řeší stejný druh problému: nad známým stavem vracejí typované uzavřené rozhodnutí místo volného textu. Oba používají typy choice, score a noul.

Vlastnost	Clef	Jev
Dostupnost	Cloudflare Workers AI nebo lokální váhy	API TypeSafe System One
Licence vah	Apache-2.0	služba dostupná přes API
Vstup podle dokumentace	text, JSON, obraz; upstream uvádí i video	textový stav a otázky
Hostovaný kontext	65 536 tokenů ve Workers AI	64 tisíc tokenů na request
Výstup	uzavřené odpovědi a pravděpodobnosti	uzavřené odpovědi, pravděpodobnosti a confidence

Shodné názvy typů otázek nejsou důkazem kompatibility API ani srovnatelné přesnosti. Pro přechod z Jevu na Clef je potřeba ověřit formát požadavků, význam vrácených hodnot a kvalitu na vlastních datech.

Clef není náhrada za běžný generativní LLM. Není určen pro psaní článků, otevřenou konverzaci ani odpověď, jejíž možné výsledky nelze předem vymezit. V takovém případě je vhodnější generativní model.

Také není vhodné vybírat mezi Clefem, Clef-Flashem a Jevem jen podle počtu parametrů nebo deklarovaného kontextu. Správné rozhodnutí vyžaduje malé evaluační testy na vlastních anonymizovaných případech, včetně nejednoznačných vstupů a kontrol prahů pravděpodobnosti.