Clef API
Cloudflare 开源的 Clef 决策模型系列：Clef (27B) 与 Clef Flash (9B) 可将状态和类型化问题转化为概率决策。
Clef API
cloudflare/clef
Cloudflare Clef 是一款 27B 多模态决策模型，可将文本、JSON、图像或视频转化为基于概率的结构化 JSON 答案。
Clef API 背景介绍
概述
Clef 是 Cloudflare 推出的开源决策模型系列，由 Cloudflare Workers AI 提供服务。它将状态及类型化问题的 Schema 转化为决策，在单次前向传播中返回每个问题中每个允许选项的概率。该系列包含 Clef（基于 Qwen3.8-27B 微调的 27B 多模态模型）和 Clef Flash（基于 Qwen3.5-9B 微调的高速 9B 模型）。
发展历史
Cloudflare 公开发布了 Clef 决策模型作为开源权重模型（Apache-2.0 协议）。Clef 是基于 Qwen3.8-27B 及其视觉编码器加上联合 Schema 头进行后训练的；Clef Flash 则是基于 Qwen3.5-9B 进行后训练的更小、更快变体。两者均由 Cloudflare Workers AI 托管提供服务。
关键创新
- 单次前向传播即可返回每个问题中每个选项的概率
- 联合 Schema 头对所有问题的全部选项进行联合打分
- 支持文本、JSON 和图像作为输入
- 无自由文本生成，无需输出解析
- 完全兼容 Jev 和 SystemOne 决策 API
Clef API 技术规格
架构
Clef 使用带有视觉编码器的 Qwen3.8-27B 主干网络（以标准分片 safetensors 格式存储），外加一个联合 Schema 头，该 Schema 头读取主干网络的最终隐状态，将状态中的证据路由到各个问题，并联合评估所有选项。Clef Flash 则采用更小的 Qwen3.5-9B 主干网络。
参数
Clef：270 亿参数（27B）。Clef Flash：90 亿参数（9B）。
功能
- 基于文本、JSON 和图像的多模态决策能力
- 选择题、打分题以及真/假（noul）类型的问题
- 工作流路由与工具选择
- 分类与安全护栏（Guardrails）
- 结构化、Schema 驱动的决策
局限性
- 不支持自由格式文本生成，输出仅为决策结果
- Clef 需通过自定义代码或 Cloudflare Workers AI 在 CPU/GPU 上提供服务
Clef API 性能
优势
- 在分类、工具检索和推理基准测试中表现出高决策准确率
- 极低延迟
- 对所有问题与选项进行联合打分
- Clef Flash 专为高速度进行了优化
实际效果
Clef 面向端到端业务工作流，例如发票处理、客服分流、安全事件分类和 Agent 跟踪可观测性，适用于要求快速且一致的结构化决策场景。
Clef API 适用场景
应用场景
- 当您需要针对文本或图像做出快速、一致的路由或分类决策时。Clef API 系列为每个选项返回校准后的概率，而非自由格式文本。
- 当您在构建需要可靠选择工具或安全护栏的 Agent 工作流时。Clef API 在单次前向传播中为每个允许的选项打分，以实现低延迟决策。
- 当您处理发票等业务文档并需要结构化决策时。Clef API 能直接将状态及类型化问题的 Schema 映射为概率结果。
最佳实践
- 使用明确的类型（noul、choice 或 score）和清晰的标准来定义每个问题
- 让状态专注于当前决策，以最大化决策准确率
- 当相比极限准确率更注重延迟和成本时，请选择 Clef Flash