一、模型概述Jev-1.13.0别名 jev-latest是 TypeSafe AI 推出的 System One 系统1决策模型区别于传统生成式大模型该模型不产出自由文本内容仅输出标准化结构化判定数据适配程序自动化解析与业务逻辑联动。模型核心能力为并行多维度结构化决策单次请求可提交多组判定问题同步返回概率分布、置信度、分级评分等可量化结果无需二次文本解析可直接对接代码逻辑适用于各类自动化判定场景。核心技术特征无自由文本输出仅返回标准化 JSON 结构化数据适配机器读取降低业务解析成本批量并行判定单次请求支持多组独立问题并行计算无串行延迟损耗量化结果输出支持概率值、置信度、分级加权分数三类量化结果判定标准可量化、可阈值管控工程化适配输出格式固定、规则清晰可直接嵌入自动化业务流程、智能网关、Agent 风控逻辑适用技术场景工单智能分流同步判定工单诉求类型、归属业务线、紧急优先级内容合规校验批量判定内容违规状态、匹配违规类目对话意图识别客服、智能对话场景的用户诉求分类、服务满意度量化打分智能风控校验Agent 工具调用、业务操作前的风险等级判定置信度分层路由低置信度判定结果自动流转人工复核提升判定准确率非结构化数据结构化抽取从文本、业务数据中完成固定维度枚举判定二、国内接入适配说明Jev 官方原生接口与 SDK 针对海外网络环境适配国内开发者直接接入存在网络波动、协议不统一、计费口径差异化、日志不可观测等适配问题。基于通用 AI 网关的兼容接入方式是国内工程落地的主流方案。通过兼容 OpenAI、Anthropic 标准协议的统一网关可复用现有工程架构、统一密钥鉴权、标准化用量统计降低多模型混合部署的适配成本。本文基于通用网关规范标准化 Jev 模型接入流程与参数定义。三、接入前置准备1. 鉴权配置使用平台标准 API 密钥sk- 开头格式密钥统一用于所有模型接口鉴权无需单独配置 Jev 专属密钥。2. 接口端点规范强制Jev 模型专属请求端点POST https://api.new.bi/v1/responses重要技术规范禁止使用/v1/chat/completions端点调用该模型。该端点无法适配 Jev 原生返回字段会导致 Token 用量统计失真、计费数据异常仅/v1/responses可精准匹配上游原生用量数据。3. 通用请求头Content-Type: application/json Authorization: Bearer {你的sk密钥}四、请求参数完整规范所有参数严格遵循下述定义缺失、格式错误均会触发接口异常。顶层参数数据类型必填参数说明modelstring是固定取值jev-1.13.0inputany是网关校验占位字段不参与模型判定逻辑固定填写 placeholder 即可statestring/object/array是待判定的完整业务上下文支持三种格式推荐 object 结构化传参questionsobject是自定义判定问题集合key 为自定义问题唯一标识value 为问题配置支持三类问题混用核心参数详解1. state 上下文参数用于承载所有需要模型判定的原始业务数据支持三种传参形式适配不同业务场景纯文本适用于单条用户话术、简短文本判定结构化对象推荐适用于多维度业务数据无需手动拼接文本数据可读性更强数组适用于多轮对话、多条日志等聚合类上下文数据2. questions 三类判定规则核心单次请求可自由混用三类判定类型所有问题独立并行计算互不干扰。类型一noul 是非判定用于二元布尔判定输出 0~1 浮点概率值代表「条件成立」的概率无置信度字段。is_refund: { type: noul, instructions: 用户是否发起退款申请, criteria: { true: 用户明确提出退款诉求, false: 无任何退款相关诉求 } }必填规则必须配置 instructionscriteria 为可选用于明确判定边界。类型二choice 单选枚举分类用于固定枚举值单选判定返回最优选项、全维度概率分布、判定置信度支持 1~255 个枚举选项。department: { type: choice, instructions: 工单归属业务团队判定, criteria: { billing: 账单、发票、退款类业务, technical: 产品功能缺陷、集成故障类业务, account: 账号登录、账号资料类业务 } }必填规则type、criteria 为必填criteria 必须为对象格式禁止数组格式。类型三score 有序等级打分用于有序层级量化评分输出加权连续分数可跨等级、各等级概率分布支持 2~10 个等级。frustration: { type: score, instructions: 用户情绪等级判定, criteria: [平静, 沮丧, 非常愤怒] }必填规则type、criteria 为必填criteria 必须为数组格式数组顺序对应等级优先级。五、响应结果规范完整响应结构{ model: jev-1.13.0, answers: { is_refund: { type: noul, noul: 0.96 }, department: { type: choice, choice: billing, confidence: 0.88, probabilities: { billing: 0.91, technical: 0.05, account: 0.04 } }, frustration: { type: score, score: 1.2, confidence: 0.71, legend: { 0: 平静, 1: 沮丧, 2: 非常愤怒 }, probabilities: { 0: 0.1, 1: 0.7, 2: 0.2 } } }, usage: { input_tokens: 1970, output_tokens: 70 } }响应字段解析要点避坑score 类型的 legend、probabilities 均为对象格式非数组需通过 key 匹配等级answers 内部字段顺序不固定业务取值必须通过自定义问题 key 匹配禁止依赖排序下标usage 字段数据为上游原生真实用量是唯一计费统计依据noul 类型无 confidence 置信度字段仅返回概率值六、多语言调用示例1. Curl 通用调用示例curl -X POST https://api.new.bi/v1/responses \ -H Authorization: Bearer 你的sk密钥 \ -H Content-Type: application/json \ -d { model: jev-1.13.0, input: placeholder, state: { message: 订单重复扣费申请退款, policy: 重复扣款符合退款条件, order: { charges: [49, 49] } }, questions: { is_refund: { type: noul, instructions: 用户是否申请退款 }, department: { type: choice, instructions: 工单归属团队, criteria: { billing: 账单退款, technical: 功能故障, account: 账号问题 } }, frustration: { type: score, instructions: 用户情绪等级, criteria: [平静, 沮丧, 非常愤怒] } } }2. Python Requests 极简调用import requests def jev_decision(state, questions, api_key): url https://api.new.bi/v1/responses headers { Authorization: fBearer {api_key}, Content-Type: application/json } payload { model: jev-1.13.0, input: placeholder, state: state, questions: questions } res requests.post(url, headersheaders, jsonpayload, timeout60) res.raise_for_status() return res.json()3. Python OpenAI SDK 适配调用from openai import OpenAI client OpenAI( base_urlhttps://api.new.bi/v1, api_key你的sk密钥 ) response client.responses.with_raw_response.create( modeljev-1.13.0, inputplaceholder, extra_body{ state: 用户支付页面空白无法完成交易, questions: { is_bug: {type: noul, instructions: 用户是否反馈产品故障} } } ) data response.http_response.json() print(data[answers][is_bug][noul])4. JavaScript 调用示例const getJevResult async () { const res await fetch(https://api.new.bi/v1/responses, { method: POST, headers: { Authorization: Bearer ${process.env.API_KEY}, Content-Type: application/json }, body: JSON.stringify({ model: jev-1.13.0, input: placeholder, state: 用户反馈支付功能异常, questions: { is_bug: { type: noul, instructions: 是否为产品功能故障反馈 } } }) }) return await res.json() }七、业务结果落地逻辑模型输出为量化结构化数据可直接对接自动化业务逻辑无需人工解析是非判定阈值管控配置固定概率阈值高于阈值自动触发对应业务流程低于阈值拦截或复核分类置信度路由高置信度结果自动流转对应业务模块低置信度结果转入人工审核队列等级分数分级处理依据加权分数划分优先级、风险等级实现业务分层处理八、计费统计规范模型计费以接口返回usage.input_tokens为唯一统计标准数据同步上游官方真实用量无估算偏差。仅/v1/responses端点可正常解析 Jev 原生 Token 字段/v1/chat/completions端点无法适配字段规范会导致用量统计失真严禁用于该模型调用。output_tokens 支持自定义倍率配置可根据业务需求适配官方输出免费的计费口径。九、常见报错与故障排查报错提示故障原因解决方案model, state and questions are required缺失核心必填参数补全 model、state、questions 三个顶层参数input is required缺失 input 占位参数固定填写 input: placeholderstate must be a string, object or arraystate 传参格式非法数字、空值等统一改为字符串、对象或数组格式unsupported type in questions问题类型非法仅支持 noul、choice、score 三类类型choice criteria format errorchoice 枚举格式错误criteria 改为对象格式控制选项数量1-255个score criteria format errorscore 等级格式错误criteria 改为数组格式等级数量控制2-10个max_tokens_exceeded单请求上下文超量拆分 state 上下文单组判定上下文控制在32k token内十、通用限制与适配规范全局上下文上限64k token单条 state单问题上限32k token输入模态仅支持文本数据不支持图片、音频、视频等多媒体内容模型训练基底以英文场景为主中文场景建议提前做精度适配测试速率限制动态限流峰值 250k token/s、1200 请求/分钟无效参数temperature、stream、max_tokens 等生成式模型参数对本模型无作用传参无效请求特性不支持流式输出所有请求统一返回完整 JSON 结果十一、常见开发误区规避串行提问误区无需单问题单次请求模型原生支持多问题并行判定串行调用会增加请求频次、损耗性能二次解析误区输出为标准化结构化数据无需正则、大模型二次解析可直接取值用于业务逻辑端点混用误区严格区分接口端点混用聊天接口会导致计费、统计、结果解析异常十二、FAQ 技术答疑Q1国内环境如何稳定接入 Jev 模型通过兼容标准协议的 AI 网关接入复用现有 OpenAI 适配代码修改请求地址与鉴权密钥即可无需重构工程架构。Q2模型是否会生成自然文本不会。该模型为纯决策模型无文本生成能力所有输出均为量化结构化判定数据。Q3OpenAI SDK 是否可以适配调用可以。通过extra_body传递 Jev 专属参数使用with_raw_response获取原生结构化结果。Q4noul 与 choice 的 criteria 参数区别noul 的 criteria 为可选参数核心依赖 instructionschoice 的 criteria 为必填参数用于定义全部枚举判定维度。Q5score 分数为何为小数分数为多等级概率加权计算结果支持跨等级取值更贴合精细化判定需求。