Cloudflare: Clef Omni
Cloudflare Clef Omni là mô hình ra quyết định đa phương thức với kiến trúc nền MoE có tổng cộng 30B tham số và 3B tham số hoạt động. Mô hình đánh giá văn bản, trạng thái có cấu trúc và nội dung đa phương tiện được cung cấp theo các câu hỏi có kiểu xác định, rồi trả về xác suất và quyết định trong phạm vi đã định. Đầu ra là lựa chọn, xác suất đúng hoặc điểm theo các mức có thứ tự, thay vì văn bản được sinh ra.
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 Omni là mô hình hỗn hợp chuyên gia đa phương thức trong họ mô hình ra quyết định Clef. Mô hình được hậu huấn luyện từ kiến trúc nền chuyên về hiểu nội dung Qwen3-Omni-30B-A3B-Instruct, với tổng cộng 30B tham số và 3B tham số hoạt động. Cloudflare bổ sung một đầu xử lý lược đồ kết hợp để chuyển bằng chứng đến các câu hỏi được yêu cầu và chấm điểm đồng thời những phương án được phép. Kết quả là quyết định có kiểu xác định kèm xác suất, thay vì lời giải thích, bản chép lời hay đầu ra giọng nói được sinh ra.
Chuẩn bị hai phần chính: trạng thái mô tả tình huống và ánh xạ các câu hỏi có tên. Trạng thái có thể là văn bản hoặc JSON có cấu trúc; các kiểu đầu vào gốc của mô hình còn bao gồm hình ảnh, âm thanh và video. Mỗi câu hỏi nêu điều cần quyết định và những câu trả lời được phép. Giữ định danh ổn định để ứng dụng có thể liên kết từng câu trả lời nhận được với câu hỏi ban đầu. Mô tả phương án rõ ràng giúp danh mục có ý nghĩa; một nhãn ngắn, mơ hồ có thể che khuất khác biệt mà quy trình thực sự cần phân biệt.
Định dạng bản ghi có ba kiểu câu hỏi. Câu hỏi noul hỏi về điều kiện đúng/sai và trả về xác suất điều kiện đó đúng. Câu hỏi choice định nghĩa các phương án có tên và trả về phương án được chọn, xác suất của từng phương án cùng một giá trị độ tin cậy riêng. Câu hỏi score định nghĩa các tiêu chí có thứ tự, được đánh chỉ số từ 0, và trả về điểm có trọng số xác suất, bảng chú giải cùng các xác suất. Điểm có thể là số thập phân vì phản ánh phân bố trên các mức. Do đó, quyết định chứa nhiều thông tin hơn một nhãn đơn lẻ nhưng vẫn nằm trong giới hạn của lược đồ được cung cấp.
Để xem xét bằng hình ảnh, cung cấp ảnh rõ nét và điều kiện cần đánh giá. Ví dụ là bản ghi lắp đặt với các câu hỏi: nhãn nhận dạng có nhìn thấy được không, danh mục tình trạng đã định nghĩa nào phù hợp, và bằng chứng có đủ để xem xét không. Tách riêng các quan sát: nhãn nhìn thấy được là câu hỏi khác với việc công trình lắp đặt trông có vẻ đã hoàn tất. Đầu ra có thể giúp ứng dụng chuyển bản ghi đến đúng nơi hoặc đánh dấu điều kiện cần xem xét; bản thân mô hình không thực hiện kiểm tra, thay đổi bản ghi hay tạo báo cáo bằng văn bản.
Với âm thanh và video, tập trung câu hỏi vào bằng chứng mà đoạn nội dung được cung cấp có thể hỗ trợ. Một lần xem xét thiết bị thực tế có thể bao gồm ảnh, bản ghi âm và video ngắn, với câu hỏi liệu có âm thanh cụ thể hay một bộ phận có đang chuyển động rõ ràng không. Nhà sản xuất mô tả việc xử lý đường âm thanh của video cùng các khung hình khi mọi video trong bản ghi đều có âm thanh. Giữ mối liên hệ giữa nội dung đa phương tiện và trạng thái bằng văn bản, đồng thời tránh yêu cầu mô hình phân loại sự kiện nằm ngoài khoảng thời gian được đính kèm.
Hồ sơ dịch vụ do nhà sản xuất lưu trữ nêu ngữ cảnh 64.000 token và từ một đến 64 câu hỏi. Dịch vụ nhận tối đa bốn ảnh, bốn đoạn âm thanh và hai video, với mỗi đoạn âm thanh tối đa 300 giây và mỗi video tối đa 60 giây. Đây là giới hạn của giao diện nhà sản xuất được mô tả trong tài liệu. Nội dung đa phương tiện và câu hỏi chiếm ngữ cảnh; quá nhiều nội dung có thể làm yêu cầu thất bại, còn trạng thái văn bản dài có thể bị cắt để vừa ngữ cảnh. Đặt bằng chứng quyết định trong một bản ghi tập trung và chuẩn bị câu hỏi trước khi dùng cửa sổ ngữ cảnh cho lịch sử không liên quan.
Giao diện do nhà sản xuất lưu trữ nhận nội dung đa phương tiện nhúng trực tiếp thay vì liên kết từ xa. 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 ảnh sau giải mã là 8 MiB. Mỗi đoạn âm thanh tối đa 8 MiB và 300 giây; mỗi video tối đa 16 MiB và 60 giây. Tổng dung lượng âm thanh và video sau giải mã không quá 16 MiB; video được lấy mẫu ở tốc độ hai khung hình mỗi giây. Các giới hạn này thuộc giao diện của nhà sản xuất đó; bộ mã hóa có trọng số mở chấp nhận thêm các dạng biểu diễn cục bộ. Khả năng âm thanh của kiến trúc nền hiểu nội dung không có nghĩa mô hình ra quyết định này tạo âm thanh: các thành phần sinh giọng nói không được dùng để chấm điểm quyết định.
Đối với hỗ trợ khách hàng hoặc định tuyến quy trình, định nghĩa danh mục và tiêu chí có thứ tự từ các quy tắc vận hành thực tế. Một bản ghi phiếu hỗ trợ có thể hỏi nhóm nào nên xử lý, tác động có khẩn cấp không và mức độ nghiêm trọng nào phù hợp nhất với bằng chứng. Đầu ra quan sát được là tập hợp câu trả lời có kiểu xác định dưới tên các câu hỏi đó. Xem xét toàn bộ phân bố xác suất khi các danh mục có giá trị gần nhau và quy định rõ cách ứng dụng xử lý những trường hợp không chắc chắn. Xác suất cao là đánh giá của mô hình về bằng chứng được cung cấp, không phải bằng chứng rằng điều kiện đã được xác minh độc lập.
Giữ trạng thái, lược đồ câu hỏi và các câu trả lời nhận được cùng nhau khi kiểm tra kết quả. Kiểm tra xem các phương án có bao quát tình huống thực tế không, mô tả có chồng lấn không và bằng chứng quan trọng có bị bỏ sót hoặc cắt mất không. Nếu bước tiếp theo cần lời giải thích bằng văn bản, có thể dùng quyết định và tài liệu nguồn làm đầu vào cho một bước viết riêng. Vai trò hữu ích của Clef Omni là chấm điểm các phương án đã định nghĩa từ bằng chứng đa phương thức để chọn hành động tiếp theo với đầu vào và đầu ra rõ ràng, có thể kiểm tra.
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef-omni
cloudflare/clef-omniBắt đầu
Cloudflare Clef Omni là mô hình ra quyết định đa phương thức với kiến trúc nền MoE có tổng cộng 30B tham số và 3B tham số hoạt động. Mô hình đánh giá văn bản, trạng thái có cấu trúc và nội dung đa phương tiện được cung cấp theo các câu hỏi có kiểu xác định, rồi trả về xác suất và quyết định trong phạm vi đã định. Đầu ra là lựa chọn, xác suất đúng hoặc điểm theo các mức có thứ tự, thay vì văn bản được sinh ra.
- Đầ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-omni | 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.0003 / 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.0003 / 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-omni",
"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-omni'
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-omni
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 Omni
- Có những đầu vào và kết quả nào?
POST /v1/systemone·cloudflare/clef-omni:text,image→decisions- Yêu cầu sử dụng những trường nào?
POST /v1/systemone·cloudflare/clef-omni:model,provider,questions,session_id,state,trace,user