Cloudflare: Clef Flash
Cloudflare Clef Flash là mô hình ra quyết định Clef nhỏ hơn với 9B tham số, được thiết kế để phân loại nhanh và chọn bước trong quy trình. Mô hình đánh giá văn bản, trạng thái có cấu trúc và đầu vào hình ảnh theo các câu hỏi có tên, rồi trả về xác suất của từng phương án, danh mục được chọn hoặc điểm theo các mức có thứ tự mà không sinh văn bản.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Cloudflare Clef Flash là mô hình ra quyết định nhỏ hơn trong họ Clef, được xây dựng bằng cách hậu huấn luyện Qwen3.5-9B cùng bộ mã hóa thị giác của nó. Một đầu xử lý lược đồ kết hợp đọc bằng chứng từ đầu vào và chấm điểm các câu trả lời được phép cho mọi câu hỏi được yêu cầu trong một lượt truyền xuôi. Vai trò của mô hình là tạo phân loại và quyết định trong phạm vi đã định cho quy trình. Đầu ra là kết quả có kiểu xác định kèm xác suất, thay vì câu trả lời hội thoại mà ứng dụng phải diễn giải thành một danh mục.
Mô tả tình huống trong trạng thái dạng văn bản hoặc JSON và định nghĩa câu hỏi riêng. Mỗi câu hỏi cần tên ổn định, kiểu và chỉ dẫn rõ ràng; câu hỏi về danh mục hoặc điểm còn định nghĩa các tiêu chí được phép. Với thông điệp hỗ trợ, một câu hỏi có thể phân loại vấn đề, câu khác đánh giá mức khẩn cấp và câu khác xác định bản ghi có thiếu thông tin cần cho bước tiếp theo không. Giữ nguyên cách diễn đạt thực tế của khách hàng, lịch sử liên quan và quy tắc vận hành trong trạng thái để quyết định gắn với bằng chứng.
Ba kiểu câu hỏi đáp ứng các nhu cầu khác nhau. Kết quả noul là xác suất một điều kiện đúng/sai được thỏa mãn. Kết quả choice xác định một phương án có tên và bao gồm xác suất trên các phương án thay thế cùng giá trị độ tin cậy. Kết quả score đánh giá các tiêu chí có thứ tự và trả về điểm có trọng số xác suất, bảng chú giải cùng phân bố. Xác định thứ tự điểm một cách có chủ đích: đi từ “Không cần hành động” đến “Xem xét ngay” khác với một tập nhãn chủ đề không có thứ tự.
Để định tuyến nhanh, mô tả các danh mục bằng hành động hoặc ranh giới trách nhiệm thực sự phân biệt chúng. Ví dụ hữu ích là yêu cầu có các lựa chọn về truy cập tài khoản, lỗi kỹ thuật, câu hỏi tài liệu và khác, với từng phương án được giải thích. Kết quả của mô hình có thể được chuyển cho quy tắc định tuyến của ứng dụng. Phân bố gần nhau giữa lỗi kỹ thuật và truy cập tài khoản là dấu hiệu hữu ích của sự mơ hồ; quyết định rõ cách quy trình xử lý các trường hợp đó thay vì coi nhãn được chọn là chẩn đoán đã xác nhận.
Để phân loại hình ảnh, cung cấp ảnh đọc được và điều kiện mà ảnh có thể hỗ trợ. Khi xem xét biên lai, có thể hỏi tổng tiền có đọc được không và chọn trong các danh mục chất lượng tài liệu đã định nghĩa. Không nên yêu cầu một tổng tiền mới tùy ý như thể mô hình là dịch vụ trích xuất hoặc viết không giới hạn. Giao diện trọng số mở của nhà sản xuất còn chấp nhận các mảng khung hình video. Giữ mối liên hệ giữa khung hình và trạng thái bằng văn bản, đồng thời hỏi về sự kiện hoặc điều kiện nhìn thấy được trong tài liệu đó.
Tài liệu tham chiếu hiện tại cho dịch vụ do nhà sản xuất lưu trữ nêu ngữ cảnh 24.576 token, tối đa 64 câu hỏi và tối đa bốn ảnh nhúng. Mỗi ảnh PNG, JPEG hoặc WebP bị giới hạn ở 4 MiB và 16 megapixel, với tổng dung lượng sau giải mã 8 MiB; toàn bộ nội dung yêu cầu bị giới hạn ở 13 MiB và không chấp nhận liên kết ảnh từ xa. Định nghĩa câu hỏi và nội dung đa phương tiện chiếm không gian đầu vào; văn bản dài có thể bị cắt để vừa. Đặt bằng chứng quyết định trong trạng thái gọn. Cloudflare ghi rõ rằng việc giảm ngữ cảnh của dịch vụ lưu trữ không thay đổi trọng số đã phát hành, do đó cửa sổ ngữ cảnh dịch vụ và cấu hình trọng số mở vẫn là hai phạm vi khác nhau.
Đầu ra bị ràng buộc của mô hình hữu ích cho các lần kiểm tra chính sách hoặc quy trình lặp lại. Ví dụ, định nghĩa các câu hỏi riêng về việc bản ghi có đáp ứng quy tắc đầy đủ đã nêu không và danh mục theo dõi tiếp nào phù hợp. Nêu tiêu chí rõ ràng và thêm phương án cho những trường hợp các danh mục không bao quát nếu thiết kế quy trình có yêu cầu đó. Các xác suất chấm điểm phương án được cung cấp; chúng không chứng minh rằng những phương án này mô tả đầy đủ mọi tình huống thực tế.
Giữ trạng thái, lược đồ và câu trả lời nhận được cùng nhau. Khi kết quả bất ngờ, kiểm tra tiêu chí có mơ hồ không, đầu vào quyết định có thiếu không hoặc văn bản liên quan có bị cắt mất không. So sánh đánh giá của mô hình với các trường hợp đã được xem xét từ nhiệm vụ thực tế trước khi chọn ngưỡng hành động tự động. Việc Clef Flash được định vị là mô hình nhỏ hơn để ra quyết định nhanh không thay thế việc kiểm tra chi phí của quyết định định tuyến sai đối với quy trình.
Dùng kết quả có kiểu xác định làm đầu vào cho bước ứng dụng tiếp theo. Mô hình không thực hiện bước đó hay viết lời giải thích cuối cùng của bước ấy. Nếu người dùng cần báo cáo, giữ quyết định và bằng chứng nguồn để cung cấp cho quy trình viết riêng. Sản phẩm hữu ích từ Clef Flash là câu trả lời có thể kiểm tra cho từng câu hỏi có tên, kèm thông tin xác suất cần thiết để áp dụng các quy tắc của quy trình.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-flash
cloudflare/clef-flashBắt đầu
Cloudflare Clef Flash là mô hình ra quyết định Clef nhỏ hơn với 9B tham số, được thiết kế để phân loại nhanh và chọn bước trong quy trình. Mô hình đánh giá văn bản, trạng thái có cấu trúc và đầu vào hình ảnh theo các câu hỏi có tên, rồi trả về xác suất của từng phương án, danh mục được chọn hoặc điểm theo các mức có thứ tự mà không sinh văn bản.
- Đầu vào được chấp nhận
- Văn bản · Ảnh
- Kết quả
- decisions
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · System One POST /v1/systemone
- Đầu vào
text,image- Đầu ra
decisions- Định dạng đầu ra
- json
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn cloudflare/clef-flash | Mặc định— |
Trườngprovider | Loạischema | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions | Loạiobject | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngsession_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstate | Loạischema | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngtrace | Loạischema | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườnguser | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions.<id>.type | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn noul, choice, score | Mặc định— |
Trườngquestions.<id>.instructions | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquestions.<id>.criteria | Loạiobject|array | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: choice/score: bắt buộc; noul: tùy chọn. Tiêu chí của choice là đối tượng; score là mảng có minItems1. | Mặc định— |
Trườngquestions.<id>.criteria.true | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Đã cung cấp đối tượng tiêu chí noul | Mặc định— |
Trườngquestions.<id>.criteria.false | Loạistring|object|array | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Đã cung cấp đối tượng tiêu chí noul | Mặc định— |
Tổ hợp tư liệu đầu vào
noul · Bắt buộc: state, questions.<id>.type=noul, questions.<id>.instructions
choice · Bắt buộc: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · Bắt buộc: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, state, questions |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốoptional_controls | Hợp đồngprovider, session_id, trace, user |
Tham sốmultimodal_input_binding | Hợp đồngChỉ dùng biểu diễn trạng thái/tài liệu chính xác đã khai báo. Khả năng xử lý ảnh của nhà sản xuất tự nó không xác lập dạng truyền ảnh được chấp nhận riêng cho mô hình. |
Vòng đời: synchronous
Gửi ID mô hình chính xác và giữ lại toàn bộ phản hồi gốc.
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí Ailoot
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.000076 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.000076 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
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
Nhận và lưu kết quả
Ailoot Ultra · System One
json
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Giữ lại mọi câu trả lời được cung cấp theo ID câu hỏi với đúng kiểu dữ liệu, giá trị noul/choice/score, độ tin cậy, xác suất và chú giải. Toàn bộ JSON gốc chỉ được lưu và trả về sau khi quyết toán.
Nếu cần kiểm tra phản hồi gốc
Giữ nguyên thao tác ban đầu và phản hồi đầy đủ/một phần; không gửi lại POST.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngmodel | Loạistring |
Trườngid | Loạistring |
Trườngprovider | Loạistring |
Trườnganswers.<id>.type | Loạistring |
Trườnganswers.<id>.noul | Loạinumber |
Trườnganswers.<id>.choice | Loạistring |
Trườnganswers.<id>.score | Loạinumber |
Trườnganswers.<id>.confidence | Loạinumber |
Trườnganswers.<id>.probabilities | Loạiobject |
Trườnganswers.<id>.legend | Loạiobject |
Trườngusage.input_tokens | Loạiinteger |
Trườngusage.output_tokens | Loạiinteger |
Trườngusage.cost | Loạinumber |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, biểu diễn hoặc giá trị không hợp lệ | Bước tiếp theoSửa trường yêu cầu được chỉ ra. |
Bí danh
Bí danh mô hình
Ailoot Ultra cloudflare/clef-flash
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Cloudflare: Clef Flash
- Có những đầu vào và kết quả nào?
POST /v1/systemone·cloudflare/clef-flash:text,image→decisions- Yêu cầu sử dụng những trường nào?
POST /v1/systemone·cloudflare/clef-flash:model,provider,questions,session_id,state,trace,user