用途:Jev 面向需要对非结构化文本做窄判断的应用逻辑。它不生成文本、代码或解释,每次请求传入一个 state(字符串、JSON 对象或文本数组)和一组类型化问题,所有问题针对同一 state 并行作答,返回校准后的概率分布。精确计算(算术、日期比较、计数、字符串匹配、查询)应留在代码里,Jev 只做需要阅读理解的部分。
主要能力与三种原语:choice 从最多 255 个无序选项中选一个;score 在 2 至 10 个有序档位上给出分数(档位索引的概率加权均值,可为小数);noul 给出 yes/no 陈述为真的概率(0 到 1,无 confidence 字段)。问题 id 只用于代码,不发送给模型;instructions 与 criteria 值可接受字符串、JSON 对象、数组或 null,便于结构化描述。
使用方式:POST https://api.typesafe.ai/v1/systemone,Authorization: Bearer $TYPESAFE_API_KEY,请求体含 state、model 与 questions。Python 用 pip install typesafe-sdk(3.10+),TypeScript 用 npm install @typesafe-ai/sdk(Node 20+)。两个 SDK 默认对 408、429 和 5xx 重试;Python RetryPolicy.timeout 是 30 秒总预算,JS 为每次尝试 10 秒且无总预算。JS 客户端拒绝在浏览器运行,除非设置 dangerouslyAllowBrowser。
适用场景:把退款、分类、情绪、紧急度等判断拆成原子问题,由代码分支、归一化 score、用 max 聚合 verifier Noul,并按置信度设阈值(act/confirm/escalate)。
限制:仅支持文本,非英文准确率下降,需自行测试。不生成文本,不支持链式 choice 生成文本。状态不受信任,对抗性文本会影响答案,应先用自己的 Noul 筛查。阈值不跨原语通用,独立问题间无算术恒等。Choice 最多 255 项,Score 2 至 10 档,上下文 64k tokens(state 加最长单问题 32k)。限速 250k tokens/s、1,200 请求/分钟,可能未通知调整。价格每百万输入 tokens $0.042,输出免费。模型 jev-1.13.0,别名 jev-latest 与 jev-preview 均指向它。