Cloudflare је 9. октобра објавио Clef-omni као хостовани Workers AI модел за доношење одлука, који може да анализира текст заједно са сликом, аудио-снимком или видео-снимком. За програмера апликације користан је узак тест: предати моделу стање захтева и фиксни скуп питања, прегледати одговоре и препустити одлуку о усмеравању особи. Овај водич прати актуелну Cloudflare документацију о моделу и пример из објаве. BIG CHANGE није позвао API нити измерио његову тачност на захтевима за подршку.
ID модела је @cf/cloudflare/clef-omni на Workers AI. То је модел за доношење одлука: позивалац дефинише типизирана питања и дозвољене изборе, а затим добија оцене тих избора. Модел не пише одговор кориснику. Cloudflare је објавио и отворене тежине, али кораци у наставку користе његову хостовану крајњу тачку. Cloudflare-ове бројке о брзини и мерилима учинка његове су тврдње; оне не утврђују колико ће овај процес добро функционисати на вашим захтевима.
Припремите приступ и ограничен скуп питања
Потребни су вам Cloudflare налог са приступом Workers AI-ју, његов ID, Workers AI API токен и Python са инсталираним requests или алат који може да пошаље исти HTTP захтев. Cloudflare водич за REST подешавање показује где да копирате ID налога и направите токен у контролној табли. Ручно направљеном токену потребне су дозволе Workers AI - Read и Workers AI - Edit . Држите токен ван захтева и система за контролу верзија.
Слањем стварног захтева или прилога шаљете садржај корисника Cloudflare-у на обраду. Cloudflare страница о коришћењу података Workers AI-ја наводи да без изричите сагласности не користи тај садржај за обучавање модела понуђених у Workers AI-ју нити за побољшање услуга; такође наводи да се садржај може чувати када се Workers AI користи са услугом складиштења као што су R2 или KV. Пре слања корисничких захтева проверите свој важећи Cloudflare уговор и правила организације о подацима корисника, па смањите или уклоните личне податке где је то практично. Сама изјава Cloudflare-а да не обучава моделе не доказује да имате дозволу да пошаљете податке одређеног корисника.
Почните текстом како бисте прегледали одговор пре додавања медија. Cloudflare-ов пример за подршку користи стање Checkout has been failing for every customer for the last hour и поставља три питања: да ли је случај хитан (noul, типа да/не), који тим треба да га обради (choice) и колико је утицај озбиљан (score). То је документован пример, а не забележени инцидент. API прихвата стринг или структуриран објекат/низ као state. Мапа questions мора да садржи од 1 до 64 ID-а питања; свако има тип и упутства, док choice и score користе критеријуме за дефинисање дозвољених одговора.
Пошаљите текстуални захтев
Поставите CLOUDFLARE_AUTH_TOKEN у свом окружењу и замените ID налога испод. Овај Python захтев прилагођава тачну крајњу тачку и поља из Cloudflare примера модела:
import os
import requests
account_id = "your-account-id"
token = os.environ["CLOUDFLARE_AUTH_TOKEN"]
payload = {
"model": "clef-omni",
"state": "Checkout has been failing for every customer for the last hour.",
"questions": {
"urgent": {
"type": "noul",
"instructions": "Is this support request urgent?",
},
"team": {
"type": "choice",
"instructions": "Which team should handle this request?",
"criteria": {
"billing": "Payments, invoices, and refunds",
"technical": "Outages, errors, and configuration",
"sales": "Plans and upgrades",
},
},
"severity": {
"type": "score",
"instructions": "How severe is the customer impact?",
"criteria": ["No impact", "Minor", "Major", "Critical"],
},
},
}
response = requests.post(
f"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/@cf/cloudflare/clef-omni",
headers={"Authorization": f"Bearer {token}"},
json=payload,
timeout=60,
)
response.raise_for_status()
print(response.json())За успешну проверу потражите у одговору ставке answers под истим ID-овима urgent, team и severity . Cloudflare прву описује као вероватноћу хитности, другу као изабрани тим са вероватноћама његових опција, а трећу као оцену пондерисану вероватноћама чији је најнижи ниво нула. API документује и поља одговора model и usage . Прегледајте цео JSON који је враћен вашем налогу пре мапирања у апликацију. Вероватноћа је излаз модела за задато питање и стање, а не гаранција да стварни захтев припада тој редној листи. Пре поступања нека особа упореди захтев и прилоге са предложеним усмеравањем.
Додајте фотографију, снимак или видео
Cloudflare захтев за објаву смешта опционе медије у засебне низове images, audio и videos као уграђене base64 data: URL-ове. На пример, његов узорак користи data:image/png;base64,..., data:audio/mpeg;base64,... и data:video/mp4;base64,.... Да бисте локалну датотеку додали у Python payload пре requests.post, кодирајте је и додајте data URL у одговарајући низ:
import base64
from pathlib import Path
def add_media(payload, field, file_path, mime_type):
raw = Path(file_path).read_bytes()
encoded = base64.b64encode(raw).decode("ascii")
payload.setdefault(field, []).append(f"data:{mime_type};base64,{encoded}")
# Examples: use only the files present in the ticket, with their real MIME types.
# add_media(payload, "images", "photo.png", "image/png")
# add_media(payload, "audio", "recording.mp3", "audio/mpeg")
# add_media(payload, "videos", "clip.mp4", "video/mp4")Покрените add_media пре POST захтева. Нека state буде чињеничан и опишите сваки прилог; постављајте само питања на која се може одговорити на основу доступног захтева и медија. Cloudflare пример из објаве користи фотографију уређаја, звучни снимак и видео вентилатора за три питања да/не о видљивим и чујним детаљима. Апликација за подршку може да чува сопствена поља захтева у state и сопствене дозвољене редове у criteria, али те дефиниције треба проверити у односу на стварни ток рада. Услуга не прихвата удаљене URL адресе медија.
Проверите ограничења пре кодирања. страница модела дозвољава до четири PNG, JPEG или WebP слике, сваку до 4 MiB и 16 мегапиксела, уз укупно 8 MiB декодираних слика. Дозвољава до четири аудио-снимка, сваки до 8 MiB и 300 секунди, и два видео-снимка, сваки до 16 MiB и 60 секунди. Заједничко ограничење декодираног аудио и видео садржаја је 16 MiB. Видео се узоркује са два кадра у секунди; звучни запис користи се заједно са кадровима ако га има сваки видео у захтеву. Цена слике зависи од величине након промене и ограничена је на 1.024 токена по слици. Ако је прилог превелик или предугачак, нека особа изабере релевантан краћи одломак или обави проверу само текста, а оригинални медиј прегледа одвојено. Исечену или скраћену датотеку не третирајте као потпун доказ.
Проверите цену, контекст и поступање у случају грешке
Cloudflare тренутно наводи цену Clef-omni модела од $0,15 за милион улазних токена и каже да не наплаћује излазне токене. Медији се претварају у улазне токене по тој цени. Страница модела наводи око 780 токена по минуту аудио-снимка и до око 15.400 токена по минуту видео-снимка максималне резолуције, уз додатне аудио токене ако видео има звук. Цена слике зависи од промењене величине и ограничена је на 1.024 токена по слици. То су правила наплате, а не фиксна цена по прилогу.
Хостовани модел има контекст од 64.000 токена. Медији и питања урачунавају се у њега. Ако премаше ограничење, Cloudflare каже да захтев неће успети; у супротном, дугачак текст у state може бити скраћен да стане. Враћени одговор зато не доказује да је модел размотрио сваки ред дугачког захтева. Ако захтев не успе, прегледајте HTTP грешку и смањите или уклоните прилоге у оквиру документованих ограничења пре поновног покушаја. Ако успе, проверите да ли су присутни очекивани ID-ови питања, сачувајте оригинални захтев за проверу и упоредите предложено усмеравање са доказима. Вероватноће модела могу помоћи рецензенту да усмери пажњу, али гаранцију услуге или безбедан аутоматски праг треба проценити на сопственим означеним захтевима.
Велика промена
Cloudflare-ово издање од 9. октобра додаје аудио и видео у хостовани Clef модел за одлучивање, који се већ користио за текстуална питања уз слике. Програмер може да пошаље стање једног захтева са подржаним медијима и добије одговоре по фиксној шеми у једном Workers AI захтеву. Тим апликације и даље мора да одлучи која питања припадају тој шеми, тестира рад на сопственим захтевима и тражи људско одобрење пре одговора или усмеравања.
Извори и додатна литература
- Cloudflare документација модела Clef-omni, проверена 10. октобра 2026. Примарни извор за ID хостованог модела, API поља и пример, ограничења медија и контекста, облик одговора и наведену цену токена. Документација описује понашање услуге; BIG CHANGE није извршио захтев.
- Cloudflare објава о покретању Clef-omni модела, 9. октобар 2026. Потврђује датум покретања и даје пример захтева са уграђеним медијима. Бројке о учинку и мерилима су сопствене тврдње Cloudflare-а.
- Cloudflare Workers AI REST подешавање, последње ажурирање 15. септембра 2026, проверено 10. октобра. Показује како се добијају ID налога и API токен и наводи дозволе потребне за ручно направљен токен.
- Коришћење података Cloudflare Workers AI-ја, последње ажурирање 21. априла 2026, проверено 10. октобра. Објашњава обраду садржаја корисника, наведену забрану употребе за обучавање и побољшање услуге без изричите сагласности, могуће чување уз посебну услугу складиштења и границу важећег уговора. Не одређује да ли програмер сме да пошаље одређени захтев или снимак.
