Cloudflare Clef 与 Clef-flash：接入与验证指南

Clef 面向预先定义输出的问题。模型卡描述了 27B 的 Clef 与 9B 的 Clef-flash，把给定证据映射为选项概率，而非开放式回复，可用于队列选择、量表评分和有边界的 Agent 步骤。它们不是动作执行器：队列答案仍需程序分流，工具建议仍需权限批准。产品设计中应区分模型判断与常规代码校验。比较指南说明何时值得把这条路径与托管 Jev 一起评估。

Cloudflare 公布了 @cf/cloudflare/clef 与 @cf/cloudflare/clef-flash 两条 Workers AI 模型路由，可通过 Workers 绑定或账户级 REST 请求访问；自行运行权重是另一项部署工作。复制示例前先确定边界，它决定凭据、区域和运维责任。账户 Token 只放在服务端环境，不进入公共页面包。应用只获得必要权限，政策允许时单独使用测试凭据。查询到模型不代表生产接入成功，还要检查真实请求的响应、超时和用量。

下方是依据文档原创的 REST 示例，不是 JevModel 请求。通过服务端环境设置账户 ID，并使用你自己的 Cloudflare 授权 Token。示例只请求路由建议，并提供 review 出口。验证传输时保持 state 简短，便于人工检查。先看 HTTP 状态，再看 Cloudflare success/errors 包装，最后检查 result 和 queue 答案。不要硬编码概率，也不能认为任何成功 JSON 都含有可执行答案。执行命令可能产生提供方费用；本文未执行，也未展示真实结果。

curl --fail-with-body "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run/@cf/cloudflare/clef" \
  -H "Authorization: Bearer $CLOUDFLARE_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"clef","state":"The export fails, and the customer also asks about a duplicate invoice.","questions":{"queue":{"type":"choice","instructions":"Choose the next review queue from the evidence.","criteria":{"billing":"Only a payment or invoice issue needs review.","technical":"Only a software error needs review.","review":"Multiple issues or insufficient evidence need human review."}}}}'

小型答案集合比复杂分类树更容易调试。先选择对应不同、可撤回动作的类别。账单与技术团队职责重叠时，应先解决政策重叠，不要让模型替团队定政策。选项描述写适用条件，而不重复标签。评分量表用可观察证据区分相邻等级；是/否题也要决定缺失信息如何处理，并写入应用规则。问题版本由服务负责人复核；即使代码没变，标签变化仍可能改变运行行为。

当前 Workers AI 参数文档描述了嵌入 PNG、JPEG 或 WebP 数据的可选 images 数组，最多四张，并有单图、解码总大小限制，不接受远程 URL。模型简介也提到视频，但不能把简介当成这条 REST 路径的完整视频上传协议，应遵循实际服务端 schema。先使用非敏感、可人工标注预期答案的图片，检查解码、方向和缺失证据处理。若先 OCR 转文字，也评估预处理阶段；OCR 错误可能是判断失败根因。

涉及后果的路由不能只读选中项。读取完整答案，观察清晰、含糊和范围外案例的概率变化。均匀分布、不可用结果与自信错误是三种条件，程序应保持区分。用独立标注样本选择阈值，按类别检查表现，而不只报告平均值。良好总分可能掩盖账户访问或少数语言的重复错误。鉴权和账户恢复放在分类器之外；客服演示中将不确定案例交给人工，并附证据与问题版本。

评估本地 Clef 时使用模型卡真实的决策服务说明。通用部署小工具可能展示聊天生成命令，而决策模型需要自身加载与评分路径。下载权重前记录模型 revision、运行库、设备、精度和预期显存。先验证单个请求与答案 schema，再测并发；启动、冷请求、加载与重启都纳入运维评估。若需要自定义模型代码，按团队软件政策审查。公开权重提高控制权，却不会自动提供监控、访问控制、备份与值班运维。

2026-10-07 核验时，Cloudflare 模型页面列出的输入价为 Clef 每百万 Token $0.24、Clef-flash $0.09。这是 Workers AI 直接模型价，不是 JevModel 套餐，也不是应用总账单承诺。用实际输入测用量，确定预算前复核当前报价，按需要计入传输、图像准备、重试和人工复核。选择 flash 前也要满足同样的错误要求，不能只因单价更低。试运行应得到可接受判断的实测成本。

首次试运行留下问题定义、独立标注小型数据集、失败案例清单与响应契约说明。服务团队负责类别含义，工程团队负责传输校验，流程负责人批准风险阈值。先旁路运行，再允许标签改变客户记录。分析分歧，区分输入、分类体系、解析器与模型错误。第一项任务有可接受错误预算和回退后才扩展。可以在 JevModel 练习问题设计，但本站不提供 Clef，不代配置 Cloudflare，也不能将本站密钥变成 Workers AI Token。