Cloudflare: Clef Flash
Cloudflare Clef Flash je menší rozhodovací model Clef s 9B parametrami, určený na rýchlu klasifikáciu a voľby v pracovných postupoch. Vyhodnocuje text, štruktúrovaný stav a vizuálne vstupy vzhľadom na pomenované otázky a vracia pravdepodobnosti pre jednotlivé možnosti, vybranú kategóriu alebo zoradené skóre bez generovania textu.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Cloudflare Clef Flash je menší rozhodovací model v rodine Clef, vytvorený dotrénovaním modelu Qwen3.5-9B spolu s jeho vizuálnym kódovačom. Spoločná hlava schémy číta dôkazy zo vstupu a v jedinom doprednom prechode hodnotí povolené odpovede pre každú požadovanú otázku. Jeho úlohou je vytvárať ohraničené klasifikácie a rozhodnutia v pracovnom postupe. Výstupom je typovaný výsledok s pravdepodobnosťami, nie konverzačná odpoveď, ktorú by aplikácia musela interpretovať ako kategóriu.
Situáciu opíšte v textovom alebo JSON stave a otázky definujte samostatne. Otázka potrebuje stabilný názov, typ a jasný pokyn; otázky s kategóriou alebo skóre definujú aj svoje povolené kritériá. Pri správe podpory môže jedna otázka klasifikovať problém, ďalšia posúdiť naliehavosť a ďalšia určiť, či v zázname chýbajú informácie potrebné pre ďalší krok. Skutočné formulácie zákazníka, relevantnú históriu a prevádzkové pravidlá ponechajte v stave, aby bolo rozhodnutie naviazané na dôkazy.
Tri typy otázok slúžia rôznym potrebám. Výsledok typu noul je pravdepodobnosť, že podmienka pravda/nepravda platí. Výsledok typu choice určuje jednu pomenovanú možnosť a obsahuje pravdepodobnosti naprieč alternatívami spolu s hodnotou istoty. Výsledok typu score vyhodnocuje zoradené kritériá a vracia ich skóre vážené pravdepodobnosťou, legendu a rozdelenie. Poradie skóre definujte zámerne: posun od „Nie je potrebný žiadny zásah“ k „Okamžitá kontrola“ je niečo iné než nezoradená množina tematických štítkov.
Pri rýchlom smerovaní opíšte kategórie pomocou akcií alebo hraníc zodpovednosti, ktoré ich skutočne odlišujú. Užitočným príkladom je požiadavka s voľbami prístup k účtu, technická porucha, otázka k dokumentácii a iné, pričom každá možnosť je vysvetlená. Výsledok modelu možno odovzdať smerovaciemu pravidlu aplikácie. Blízke rozdelenie medzi technickou poruchou a prístupom k účtu je užitočným dôkazom nejednoznačnosti; explicitne rozhodnite, ako pracovný postup s takými prípadmi zaobchádza, namiesto toho, aby ste vybraný štítok považovali za potvrdenú diagnózu.
Pri vizuálnej klasifikácii dodajte čitateľný obrázok a podmienku, ktorú obrázok dokáže podložiť. Kontrola účtenky sa môže pýtať, či je celková suma čitateľná, a vybrať spomedzi definovaných kategórií kvality dokumentu. Nemala by žiadať ľubovoľnú novú celkovú sumu, akoby bol model neobmedzenou službou na extrakciu alebo písanie. Rozhranie výrobcu s otvorenými váhami prijíma aj polia snímok videa. Zachovajte prepojenie medzi snímkami a písomným stavom a pýtajte sa na viditeľné udalosti alebo stavy v rámci tohto materiálu.
Aktuálna hostovaná referencia výrobcu uvádza kontext 24 576 tokenov, až 64 otázok a až štyri vložené obrázky. Obrázky PNG, JPEG alebo WebP sú obmedzené na 4 MiB a 16 megapixelov na kus, s celkovým objemom 8 MiB po dekódovaní; celé telo požiadavky je obmedzené na 13 MiB a vzdialené odkazy na obrázky sa neprijímajú. Definície otázok a médiá spotrebúvajú vstupný priestor a dlhý text sa môže skrátiť, aby sa zmestil. Rozhodujúce dôkazy vložte do kompaktného stavu. Cloudflare dokumentuje, že zmenšenie hostovaného kontextu nezmenilo zverejnené váhy, takže hostované okno a konfigurácia s otvorenými váhami zostávajú odlišné.
Obmedzený výstup modelu ho robí užitočným pri opakovaných kontrolách pravidiel alebo pracovných postupov. Definujte napríklad samostatné otázky, či záznam spĺňa uvedené pravidlá úplnosti a ktorá kategória následného kroku platí. Kritériá udržiavajte explicitné a zahrňte možnosť pre prípady, ktoré kategórie nepokrývajú, ak je to súčasťou návrhu pracovného postupu. Pravdepodobnosti hodnotia dodané možnosti; nepreukazujú, že tieto možnosti tvoria úplný opis každej reálnej situácie.
Stav, schému a vrátenú odpoveď uchovávajte spolu. Keď je výsledok prekvapivý, preverte, či je niektoré kritérium nejednoznačné, či chýbal rozhodujúci vstup alebo či nebol relevantný text odrezaný. Pred voľbou prahov pre automatizované akcie porovnajte hodnotenia modelu s preverenými prípadmi zo skutočnej úlohy. Zaradenie Clef Flash ako menšieho modelu na rýchle rozhodovanie nenahrádza overenie toho, čo pre pracovný postup stojí nesprávne rozhodnutie o smerovaní.
Typovaný výsledok použite ako vstup pre ďalší krok aplikácie. Model tento krok nevykonáva ani nepíše jeho konečné vysvetlenie. Ak používateľ potrebuje správu, ponechajte rozhodnutie a zdrojové dôkazy k dispozícii samostatnému procesu písania. Užitočným výstupom Clef Flash je kontrolovateľná odpoveď na každú pomenovanú otázku spolu s informáciami o pravdepodobnosti, ktoré sú potrebné na uplatnenie pravidiel pracovného postupu.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashÚvod
Cloudflare Clef Flash je menší rozhodovací model Clef s 9B parametrami, určený na rýchlu klasifikáciu a voľby v pracovných postupoch. Vyhodnocuje text, štruktúrovaný stav a vizuálne vstupy vzhľadom na pomenované otázky a vracia pravdepodobnosti pre jednotlivé možnosti, vybranú kategóriu alebo zoradené skóre bez generovania textu.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- decisions
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · System One POST /v1/systemone
- Vstup
text,image- Výstup
decisions- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity cloudflare/clef-flash | Predvolené— |
Poleprovider | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions | Typobject | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polestate | Typschema | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poletrace | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.type | Typstring | PožiadavkaPovinné | Hodnoty a limity noul, choice, score | Predvolené— |
Polequestions.<id>.instructions | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polequestions.<id>.criteria | Typobject|array | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: choice/score: povinné; noul: voliteľné. Kritériá pre choice tvoria objekt; score je pole s minItems1. | Predvolené— |
Polequestions.<id>.criteria.true | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Polequestions.<id>.criteria.false | Typstring|object|array | PožiadavkaPovinné | Hodnoty a limity Platí, keď: Je zadaný objekt kritérií noul | Predvolené— |
Kombinácie vstupných podkladov
noul · Povinné: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Povinné: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Povinné: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, state, questions |
Parametermaterial_types | Špecifikáciatext, image |
Parameteroptional_controls | Špecifikáciaprovider, session_id, trace, user |
Parametermultimodal_input_binding | ŠpecifikáciaPoužite iba presne deklarovanú reprezentáciu stavu alebo dokumentu. Samotná obrazová schopnosť výrobcu nepotvrdzuje prijatý spôsob prenosu obrázka pre konkrétny model. |
Životný cyklus: synchronous
Odošlite presné ID modelu a zachovajte celú natívnu odpoveď.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.000076 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.000076 / 1K tokenov Výstup · Výstupné tokeny $0 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · System One
{
"model": "cloudflare/clef-flash",
"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-flash'
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
Prijať a uložiť výsledky
Ailoot Ultra · System One
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachováva sa každá poskytnutá odpoveď podľa ID otázky s presným typom, hodnotou noul/choice/score, mierou istoty, pravdepodobnosťami a legendou. Celý pôvodný JSON sa uloží a vráti až po zúčtovaní.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú operáciu a úplnú alebo čiastočnú odpoveď; POST znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleid | Typstring |
Poleprovider | Typstring |
Poleanswers.<id>.type | Typstring |
Poleanswers.<id>.noul | Typnumber |
Poleanswers.<id>.choice | Typstring |
Poleanswers.<id>.score | Typnumber |
Poleanswers.<id>.confidence | Typnumber |
Poleanswers.<id>.probabilities | Typobject |
Poleanswers.<id>.legend | Typobject |
Poleusage.input_tokens | Typinteger |
Poleusage.output_tokens | Typinteger |
Poleusage.cost | Typnumber |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné pole, reprezentácia alebo hodnota | Ďalší krokOpravte označené pole požiadavky. |
Aliasy
Aliasy modelov
Ailoot Ultra cloudflare/clef-flash
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Cloudflare: Clef Flash
- Aké vstupy a výsledky sú dostupné?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- Aké polia používa požiadavka?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user