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.