Cloudflare Clairic-flash 怎麼用?從收據與 PDF 擷取欄位
本文目錄
收據上可能同時印著小計、稅額、應付總額與找零。如果你的目標是固定擷取應付總額和單號,Cloudflare Clairic-flash 可以讓你預先指定欄位名稱、型別與擷取指示,再回傳欄位結果及不確定性。先把它接到待複核清單,依欄位的完整度、信心和業務規則驗收後,再決定哪些可以自動接受。
Cloudflare 在 2026 年 11 月 18 日宣布更新 Clairic 與 Clairic-flash 並釋出權重。Workers AI 模型文件將 Flash 標示為早期研究預覽。本文的呼叫格式依 11 月 20 日的模型文件整理,人工分流只用模擬資料驗證。Cloudflare 發布公告
一份 PDF 加多少張補拍照片?
Workers AI 每次允許最多四張影像或轉成影像的 PDF 頁面,兩者共用同一個上限。例如三頁 PDF 最多可再附一張照片。單檔最多 4 MiB,解碼後的附件合計最多 8 MiB,請求本文上限是 16 MiB。支援嵌入 PNG、JPEG、WebP 或 PDF,遠端 URL 與加密 PDF 會被拒絕。Clairic-flash 模型參數
以下是已有 AI binding 的 Worker 片段。pdfBase64 是應用程式從已驗證大小與格式的 PDF 取得的純 Base64 字串。照片可改走 images,並依實際格式指定 content_type。
async function readReceipt(env, pdfBase64) { return env.AI.run('@cf/cloudflare/clairic-flash', { model: 'clairic-flash', documents: [{ content_type: 'application/pdf', base64: pdfBase64 }], fields: { receipt_id: { type: 'text', instructions: '收據編號,保留前導零。' }, amount_due: { type: 'number', decimals: 0, unit: 'TWD', instructions: '新台幣應付總額,含稅,排除小計、實收現金與找零。', }, }, });}這個例子只處理整數新台幣收據。若資料中有外幣或小數,先分流到對應 schema。超過四頁的文件要保留原頁序與文件 ID,明確決定哪些頁面應共同驗證同一欄位。分段後若出現兩個不同總額,留給人工判斷。
用欄位結果決定能不能自動接受
answers 以欄位名稱為 key。對這裡使用的 text 與 number,先查 valid、complete 和 value。官方 schema 的 confidence 表示回傳值的機率,回傳值含 null;p_null 提供缺值的機率訊號。必填欄位回傳 null 時,即使模型對這次缺值有高 confidence,也要轉人工。這組檢查專用於範例欄位,日期等 typed answer 依 schema 可能另外帶 guess。
function reviewRoute(result) { const id = result?.answers?.receipt_id; const amount = result?.answers?.amount_due; const accepted = [id, amount].every(answer => answer?.valid === true && answer.complete === true && Number.isFinite(answer.confidence) && answer.confidence >= 0.95 && Number.isFinite(answer.p_null) && answer.p_null <= 0.05 );
return result?.truncated === false && accepted && typeof id.value === 'string' && id.value.trim().length > 0 && Number.isSafeInteger(amount.value) && amount.value >= 0 ? 'accept' : 'review';}0.95 與 0.05 是示意門檻。用已標註的繁中收據,分開量清晰、歪斜、缺頁和多個候選金額這幾類。至少記錄每類人工複核比例與「本來應擋下卻被接受」的筆數。有小計、稅額和折扣時,可另外擷取這些欄位後對帳。高信心分數與格式正確也可能同時出現在錯的金額上。
需要讀文件脈絡後寫摘要或解釋例外時,一般多模態 LLM 較符合工作內容。若收到資料後還要決定分派哪個部門,則可參考 Clef 的結構化決策驗收。截至查核日,Flash 定價為每百萬輸入 token 0.10 美元,影像會換算為輸入 token,無輸出 token 費。12 月 1 日的促銷截止條款適用於較大的 Clairic。Workers AI 定價
參考資料: