Skip to main content
Jev 决策
Jev 是 TypeSafe 的结构化决策模型。输入业务状态 state 和具名问题 questions,同步获得分类、评分或真假概率,而不是生成聊天文本。 POST https://api.mixroute.ai/typesafe/v1/systemone 使用 MixRoute API Key,以 Authorization: Bearer $MIXROUTE_API_KEY 认证,Content-Type: application/json。请求体保留 TypeSafe 原生的 modelstatequestions 层级,不使用 metadata、聊天 messages 或异步任务轮询。

支持模型

jev-1.13.0 是固定版本 ID,jev-latest 是最新稳定版别名,当前都调用 Jev 1.13,属于同一个模型,不是两个独立型号。以后 latest 可能随新版本发布更新;需要固定行为时使用版本 ID,并读取响应的 model 确认实际版本。 仅使用账户 模型列表 中返回的完整型号。

选择问题类型

顶层参数

问题 ID 只用于请求与答案的对应,不参与模型推理;不要把真正的问题只写在 ID 中。多个问题针对相同 state 独立评估,可以混合三种类型,但不能依赖同一次请求中其他问题的答案。需要前后依赖时,在应用层分两次调用。

问题参数

以下字段位于 questions[question_id] 内。建议为每个问题显式填写 instructions,一次只描述一个明确的判断目标。

Choice 分类

返回 choice 为概率最高的选项;probabilities 包含所有选项,概率和约为 1。可增加 other 或 insufficient_information 选项处理信息不足的输入。

Score 评分

等级索引从 0 开始:三个等级对应 0、1、2。score 是等级索引的概率加权位置,范围为 0 到等级数减 1,可以是小数,并非固定的 0-1 分数。legend 把字符串形式的索引映射回原始描述,probabilities 使用相同索引。使用返回的 score,不要直接截断为整数;需要离散等级时由应用选择映射规则。

Noul 真假判断

返回的 noul 是 0-1 的概率,不是布尔值:接近 1 倾向于真,接近 0 倾向于假,接近 0.5 表示不确定。Noul 没有单独的 confidence 字段,也不是用于衡量程度的评分;程度问题使用 Score。

输入与上下文限制

文字内容、instructions 和 criteria 都占用上下文预算。多问题请求中的 state 共用,但各个问题仍增加总输入量。不要把厂商的公开速率上限当作 MixRoute 账户的可用配额,实际限额以账户配置为准。

请求示例

设置服务端环境变量 MIXROUTE_API_KEY。下面在一次请求中混合三种问题。

响应示例

示例概率和 token 用量仅用于展示响应格式;不同输入或调用可能返回不同值。 在应用层设置概率/置信度阈值,并为不确定的输入保留人工处理或补充信息的路径。高 confidence 不保证结论正确;尤其要用自身业务数据验证非英语任务。

结构化输入

state、instructions 和描述性 criteria 可以使用原生 JSON 结构。以下示例同时展示对象指令、数组指令及结构化等级描述。

对话数组

对话记录直接作为 state 数组传入;这里的 role/text 是业务字段,不是 Chat Completions 的消息协议。

Python

需要 Python 3 和 requests。示例直接读取同步答案,不进行任务轮询或自动重复提交。

JavaScript

Node.js 18+,使用 ES module(.mjs)。API Key 仅保存在服务端,不放入浏览器代码。

价格与用量

以上为美元基础单价,实际价格以 模型广场、账户分组倍率及账单为准。输入用量包括 state 和问题定义,更多问题与选项也会增加输入 token。响应的 usage.output_tokens 可以大于 0,但输出 token 不收费。 使用 usage.input_tokens 估算费用:输入 token 数 × 输入单价 ÷ 1,000,000,再应用账户倍率。平台按内部额度逐笔结算,取整后的账单可能与直接按美元计算的微小金额略有差异。 额度换算说明见 认证与额度

响应处理

先检查 HTTP 状态,再读取 JSON。成功响应直接包含 answers;错误响应通常使用 detail,可能是字符串、对象或字段错误数组。保留响应头 x-oneapi-request-id 便于定位请求,不要记录完整 API Key。 网络超时不等于请求没有执行。重复提交会创建新的评估并可能再次计费,重试策略应由应用明确控制。