Cloudflare: Clef Flash
Cloudflare Clef Flash to mniejszy model decyzyjny Clef o rozmiarze 9B, przeznaczony do szybkiej klasyfikacji i wyborów w procesach. Ocenia tekst, ustrukturyzowany stan i dane wizualne w odniesieniu do nazwanych pytań, zwracając prawdopodobieństwa poszczególnych opcji, wybraną kategorię lub ocenę w uporządkowanej skali bez generowania tekstu.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Cloudflare Clef Flash to mniejszy model decyzyjny z rodziny Clef, zbudowany przez dalsze trenowanie Qwen3.5-9B wraz z jego koderem obrazu. Wspólna głowica schematu odczytuje materiał z wejścia i w jednym przebiegu w przód ocenia dozwolone odpowiedzi na każde wskazane pytanie. Jego rolą jest tworzenie ograniczonych klasyfikacji i decyzji w procesie. Wynik ma określony typ i zawiera prawdopodobieństwa, zamiast być odpowiedzią konwersacyjną, którą aplikacja musi zinterpretować jako kategorię.
Opisz sytuację w stanie tekstowym lub JSON-ie i osobno zdefiniuj pytania. Pytanie wymaga stałej nazwy, typu i jasnej instrukcji; pytania o kategorię lub ocenę definiują również dozwolone kryteria. W przypadku wiadomości do wsparcia jedno pytanie może klasyfikować problem, drugie oceniać pilność, a trzecie wskazywać, czy w rekordzie brakuje informacji potrzebnych do następnego kroku. Zachowaj w stanie rzeczywiste sformułowania klienta, istotną historię i zasady operacyjne, aby decyzja była powiązana z materiałem.
Trzy typy pytań odpowiadają na różne potrzeby. Wynik noul to prawdopodobieństwo spełnienia warunku prawda/fałsz. Wynik choice wskazuje jedną nazwaną opcję i obejmuje prawdopodobieństwa wszystkich alternatyw oraz wartość pewności. Wynik score ocenia uporządkowane kryteria i zwraca ich ocenę ważoną prawdopodobieństwami, legendę i rozkład. Świadomie określ kolejność ocen: przejście od „Nie wymaga działania” do „Natychmiastowy przegląd” różni się od nieuporządkowanego zestawu etykiet tematów.
Do szybkiego kierowania zgłoszeń opisz kategorie za pomocą działań lub granic odpowiedzialności, które rzeczywiście je odróżniają. Użytecznym przykładem jest zgłoszenie z opcjami: dostęp do konta, usterka techniczna, pytanie o dokumentację oraz inne, z objaśnieniem każdej opcji. Wynik modelu można przekazać do reguły kierowania w aplikacji. Zbliżone prawdopodobieństwa usterki technicznej i dostępu do konta są użyteczną wskazówką niejednoznaczności; jawnie zdecyduj, jak proces traktuje takie przypadki, zamiast zakładać, że wybrana etykieta oznacza potwierdzoną diagnozę.
Do klasyfikacji wizualnej dostarcz czytelny obraz i warunek, który obraz może uzasadniać. Przegląd paragonu może pytać, czy kwota łączna jest czytelna, oraz wybierać spośród zdefiniowanych kategorii jakości dokumentu. Nie powinien żądać dowolnej nowej kwoty, jak gdyby model był nieograniczoną usługą ekstrakcji lub pisania. Interfejs producenta dla otwartych wag przyjmuje również tablice klatek wideo. Zachowaj związek między klatkami a zapisanym stanem i pytaj o widoczne zdarzenia lub warunki w tym materiale.
Aktualna dokumentacja referencyjna hostowanego rozwiązania producenta podaje kontekst 24 576 tokenów, do 64 pytań i do czterech osadzonych obrazów. Obrazy PNG, JPEG lub WebP są ograniczone do 4 MiB i 16 megapikseli każdy, z łącznym limitem 8 MiB po zdekodowaniu; całe ciało żądania ma limit 13 MiB, a zdalne odnośniki do obrazów nie są akceptowane. Definicje pytań i media zużywają miejsce na wejściu, a długi tekst może zostać przycięty, aby się zmieścił. Umieść rozstrzygający materiał w zwięzłym stanie. Cloudflare dokumentuje, że zmniejszenie hostowanego kontekstu nie zmieniło opublikowanych wag, dlatego hostowane okno i konfiguracja otwartych wag pozostają odrębnymi kwestiami.
Ograniczony format wyjścia modelu przydaje się do powtarzalnych kontroli zasad lub procesów. Zdefiniuj na przykład osobne pytania sprawdzające, czy rekord spełnia podane zasady kompletności i która kategoria dalszego działania ma zastosowanie. Formułuj kryteria jawnie i uwzględnij opcję dla przypadków nieobjętych kategoriami, jeśli należy to do projektu procesu. Prawdopodobieństwa oceniają dostarczone opcje; nie dowodzą, że opcje stanowią pełny opis każdej rzeczywistej sytuacji.
Zachowaj razem stan, schemat i zwróconą odpowiedź. Gdy wynik zaskakuje, sprawdź, czy kryterium jest niejednoznaczne, czy zabrakło rozstrzygającego wejścia lub czy istotny tekst został ucięty. Porównaj oceny modelu ze zweryfikowanymi przypadkami z rzeczywistego zadania, zanim wybierzesz progi automatycznych działań. Pozycjonowanie Clef Flash jako mniejszego modelu do szybkich decyzji nie zastępuje sprawdzenia kosztu błędnego skierowania zgłoszenia w danym procesie.
Użyj wyniku o określonym typie jako wejścia do następnego kroku aplikacji. Model nie wykonuje tego kroku ani nie pisze jego późniejszego wyjaśnienia. Jeśli użytkownik potrzebuje raportu, zachowaj decyzję i materiał źródłowy do wykorzystania przez osobny proces pisania. Użytecznym artefaktem Clef Flash jest możliwa do skontrolowania odpowiedź na każde nazwane pytanie, wraz z informacją o prawdopodobieństwach potrzebną do zastosowania reguł procesu.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashStart
Cloudflare Clef Flash to mniejszy model decyzyjny Clef o rozmiarze 9B, przeznaczony do szybkiej klasyfikacji i wyborów w procesach. Ocenia tekst, ustrukturyzowany stan i dane wizualne w odniesieniu do nazwanych pytań, zwracając prawdopodobieństwa poszczególnych opcji, wybraną kategorię lub ocenę w uporządkowanej skali bez generowania tekstu.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- decisions
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · System One POST /v1/systemone
- Wejście
text,image- Wyjście
decisions- Format wyjściowy
- json
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity cloudflare/clef-flash | Domyślnie— |
Poleprovider | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequestions | Typobject | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polesession_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polestate | Typschema | WymaganieWymagane | Wartości i limity | Domyślnie— |
Poletrace | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleuser | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequestions.<id>.type | Typstring | WymaganieWymagane | Wartości i limity noul, choice, score | Domyślnie— |
Polequestions.<id>.instructions | Typstring|object|array | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polequestions.<id>.criteria | Typobject|array | WymaganieOpcjonalne | Wartości i limity Warunki: choice/score: wymagane; noul: opcjonalne. Kryteria choice są obiektem; score jest tablicą z minItems1. | Domyślnie— |
Polequestions.<id>.criteria.true | Typstring|object|array | WymaganieWymagane | Wartości i limity Obowiązuje, gdy: Przekazano obiekt kryteriów noul | Domyślnie— |
Polequestions.<id>.criteria.false | Typstring|object|array | WymaganieWymagane | Wartości i limity Obowiązuje, gdy: Przekazano obiekt kryteriów noul | Domyślnie— |
Kombinacje materiałów wejściowych
noul · Wymagane: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Wymagane: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Wymagane: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, state, questions |
Parametrmaterial_types | Kontrakttext, image |
Parametroptional_controls | Kontraktprovider, session_id, trace, user |
Parametrmultimodal_input_binding | KontraktUżywaj wyłącznie dokładnie zadeklarowanej reprezentacji stanu lub dokumentu. Sama obsługa obrazów przez producenta nie potwierdza zaakceptowanego sposobu przekazywania obrazów dla konkretnego modelu. |
Cykl życia: synchronous
Wyślij dokładny identyfikator modelu i zachowaj kompletną natywną odpowiedź.
Cennik
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Stawki Ailoot
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Tokeny kontekstu, więcej niż | Tokeny kontekstu, do podanej wartości włącznie | Opłata |
|---|---|---|---|---|
| KonfiguracjaPodstawowe stawki za tokeny | Tabela stawekStawka podstawowa | Tokeny kontekstu, więcej niż— | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.000076 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
| KonfiguracjaPrzedział długości żądania 1 | Tabela stawek— | Tokeny kontekstu, więcej niż0 | Tokeny kontekstu, do podanej wartości włącznieBez górnej granicy | Opłata Wejście · Tokeny wejściowe $0.000076 / 1K tokenów Wyjście · Tokeny wyjściowe $0 / 1K tokenów Wejście · Odczyt cache — / 1K tokenów Wejście · Zapis do cache — / 1K tokenów Wejście · Zapis do cache, 1 godz. — / 1K tokenów |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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
Odbieranie i zapisywanie wyników
Ailoot Ultra · System One
json
Zachowaj wszystkie ukończone wyniki
Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zachowywana jest każda odpowiedź przypisana do podanego identyfikatora pytania wraz z dokładnym typem, wartością noul/choice/score, pewnością, prawdopodobieństwami i legendą. Cały oryginalny JSON jest zapisywany i zwracany dopiero po rozliczeniu.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj pierwotną operację oraz pełną lub częściową odpowiedź; nie ponawiaj POST.
Pola odpowiedzi
| 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 |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pole, reprezentacja lub wartość | Następny krokPopraw wskazane pole żądania. |
Aliasy
Aliasy modelu
Ailoot Ultra cloudflare/clef-flash
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Cloudflare: Clef Flash
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- Jakich pól używa żądanie?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user