Cloudflare: Clef
Cloudflare Clef 是用於分類、政策檢查及代理工作流程選擇的 27B 多模態決策模型。它評估提供的狀態與具型別問題,回傳允許方案的機率、選定類別與加權分數。模型接受文字與視覺證據,不生成文章。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。
Cloudflare Clef 是 Clef 決策系列中較大的稠密模型,以附帶視覺編碼器的 Qwen3.8-27B 進行後訓練。Cloudflare 將此主幹與聯合綱要輸出頭結合,把證據導向問題,並一併為允許的選項評分。Clef 讀取情況後,在一次前向傳播中回傳帶有機率、限定範圍內的決策。輸出是分類結果,而非生成的文章、開放式報告或建議指令。
請將狀態與問題綱要準備成不同的輸入。狀態可以是字串或 JSON,表示記錄、對話、文件內容或應用程式情況。問題以穩定名稱作為鍵,回傳答案也使用相同名稱識別。請定義每個問題應確認什麼,並說明相關選項。客服記錄可以詢問應由哪個團隊處理請求、影響是否緊急,以及適用哪項嚴重程度準則,而不將這些不同決策混成單一含糊類別。
noul 問題回傳二元條件為真的機率。choice 問題回傳選定的具名選項、各選項機率與信心值。score 問題使用從零開始編號的有序說明清單,回傳期望分數、圖例與機率。小數分數具有意義,因為它概括了有序等級之間的不確定性。請在查看選定答案時一併檢視分布;兩個機率接近的選項,可能揭露輸入無法釐清的差異。
進行政策檢查時,請納入實際規則文字與記錄中的事實。例如,在文件處理流程中,可以詢問記錄是否完整、適用哪個審查類別,以及證據在多大程度上支持立即關注。不同條件請使用不同問題。模型對符合規範與否的評估,應持續連結至提供的規則與證據。如果重要條件缺失,綱要與應用程式應有刻意設計的方式處理這種不確定性。
對於視覺證據,請提供可辨讀的圖片,以及針對可見條件或預先定義類別的問題。表單品質檢查可以評估可讀性、必填區域是否存在,以及提供的品質等級中哪一個最貼切。製造商的開放權重介面也接受影片影格陣列。請保持影格順序,並指出要評估的事件。限定範圍的決策綱要能為這些資料分類;敘事性描述或任意產生新欄位的請求,則屬於不同類型的輸出。
製造商的託管參考規格列出 65,536 token 的上下文、1 至 64 個問題,以及最多四張嵌入式圖片。PNG、JPEG 或 WebP 圖片每張上限為 4 MiB 與 1,600 萬像素,解碼後總量上限為 8 MiB;整個請求本文上限為 13 MiB,不接受遠端圖片連結。輸入額度包含問題與媒體。較長的文字可能被截斷以符合容量,因此請保留決定性段落與來源標籤。這些限制描述製造商的託管圖片介面;開放權重編碼器有自己的本機輸入表示形式。
Cloudflare 的發布說明描述了針對綱要約束評分與機率校準的訓練。模型先擷取個別選項的相關證據,再考量跨欄位資訊。這能支援同一筆記錄中多個相關問題的決策,但不代表高機率就保證背後的事實為真。除了直接明確的案例,也請評估困難、不完整及類別以外的記錄。實用的決策準則應涵蓋工作流程實際遇到的情況,並明確呈現重要差異。
在代理工作流程中,輸出可決定應考慮哪個預先定義的下一步。請提供目前觀察與有清楚說明的候選動作,並保留選定選項及其機率。周邊應用程式會套用行動政策,並記錄實際做了什麼。請將執行記錄與決策結果分開:選擇審查路徑,不代表審查者已採取行動;選擇診斷步驟,也不代表該步驟已成功。
最終產物是 answers 物件,以及產生它的狀態與綱要。請用這些記錄檢視出乎預期的分類、找出含糊準則,並將結果與已審查的任務案例比較。若後續使用者需要書面解釋,決策與原始證據可作為獨立回覆撰寫步驟的輸入。Clef 提供選擇下一階段所需、限定範圍內的機率決策,並清楚記錄評估了哪些內容。
Ailoot Ultra · System One POST /v1/systemone cloudflare/clef
cloudflare/clef入門
Cloudflare Clef 是用於分類、政策檢查及代理工作流程選擇的 27B 多模態決策模型。它評估提供的狀態與具型別問題,回傳允許方案的機率、選定類別與加權分數。模型接受文字與視覺證據,不生成文章。
- 接受的輸入
- 文字 · 圖片
- 結果
- decisions
Ailoot 可用 · 輸入與方法
Ailoot Ultra · System One POST /v1/systemone
- 輸入
text,image- 輸出
decisions- 輸出格式
- json
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 cloudflare/clef | 預設值— |
欄位provider | 類型schema | 要求選填 | 值與限制 | 預設值— |
欄位questions | 類型object | 要求必填 | 值與限制 | 預設值— |
欄位session_id | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位state | 類型schema | 要求必填 | 值與限制 | 預設值— |
欄位trace | 類型schema | 要求選填 | 值與限制 | 預設值— |
欄位user | 類型string | 要求選填 | 值與限制 | 預設值— |
欄位questions.<id>.type | 類型string | 要求必填 | 值與限制 noul, choice, score | 預設值— |
欄位questions.<id>.instructions | 類型string|object|array | 要求必填 | 值與限制 | 預設值— |
欄位questions.<id>.criteria | 類型object|array | 要求選填 | 值與限制 條件: choice/score:必填;noul:選填。choice 的條件為物件;score 為陣列,並要求 minItems1。 | 預設值— |
欄位questions.<id>.criteria.true | 類型string|object|array | 要求必填 | 值與限制 適用條件: 已提供 noul criteria 物件 | 預設值— |
欄位questions.<id>.criteria.false | 類型string|object|array | 要求必填 | 值與限制 適用條件: 已提供 noul criteria 物件 | 預設值— |
輸入素材組合
noul · 必填: state, questions.<id>.type=noul, questions.<id>.instructions
choice · 必填: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object
score · 必填: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, state, questions |
參數material_types | 規格text, image |
參數optional_controls | 規格provider, session_id, trace, user |
參數multimodal_input_binding | 規格請僅使用完全相符且已宣告的狀態/文件表示方式。製造商具備圖片處理能力,並不足以證明該模型已接受特定的圖片傳遞形式。 |
生命週期: synchronous
請傳送完全相符的模型 ID,並保留完整的原生回應。
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
Ailoot 費率
各設定的價格
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 上下文 Token 數大於 | 上下文 Token 數小於或等於 | 費用 |
|---|---|---|---|---|
| 設定詞元基本費率 | 費率表基本費率 | 上下文 Token 數大於— | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.00048 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取,1 小時 — / 1K Token |
| 設定請求長度級距 1 | 費率表— | 上下文 Token 數大於0 | 上下文 Token 數小於或等於無上限 | 費用 輸入 · 輸入 Token $0.00048 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取,1 小時 — / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · System One
{
"model": "cloudflare/clef",
"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'
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
接收並儲存結果
Ailoot Ultra · System One
json
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
會保留每個已提供的問題 ID 答案,包括其確切型別、noul/choice/score 值、信心值、機率與圖例。完整的原始 JSON 會先儲存,並僅在結算後回傳。
需要檢查原始回應時
請保留原始操作與完整/部分回覆;切勿重送 POST。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位model | 類型string |
欄位id | 類型string |
欄位provider | 類型string |
欄位answers.<id>.type | 類型string |
欄位answers.<id>.noul | 類型number |
欄位answers.<id>.choice | 類型string |
欄位answers.<id>.score | 類型number |
欄位answers.<id>.confidence | 類型number |
欄位answers.<id>.probabilities | 類型object |
欄位answers.<id>.legend | 類型object |
欄位usage.input_tokens | 類型integer |
欄位usage.output_tokens | 類型integer |
欄位usage.cost | 類型number |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、表示方式或值無效 | 下一步請修正指出的請求欄位。 |
別名
模型別名
Ailoot Ultra cloudflare/clef
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Cloudflare: Clef
- 可以使用哪些輸入與結果?
POST /v1/systemone·cloudflare/clef:text,image→decisions- 請求使用哪些欄位?
POST /v1/systemone·cloudflare/clef:model,provider,questions,session_id,state,trace,user