判断请求参数
modelstring必填模型名称为
Zev-1。statestring必填需要模型分析的文本。
questionsobject必填以问题名称为键的对象。同一请求可以包含多个问题,返回时保留这些名称。
questions.<问题名称>.typestring必填固定为
noul,使用判断模式。questions.<问题名称>.instructionsstring可选描述需要判断的陈述或问题。例如:这条消息是否与账单或退款有关?
questions.<问题名称>.criteriaobject可选补充肯定和否定的判断标准。使用
true、false两个属性描述各自的含义。questions.<问题名称>.criteria.truestring可选肯定判断的标准,例如涉及付款、账单或退款。
questions.<问题名称>.criteria.falsestring可选否定判断的标准,例如仅涉及产品使用或技术支持。
判断返回字段
modelstring使用的模型名称。
answersobject与
questions中的问题名称一一对应。answers.<问题名称>.typestring固定为
noul。answers.<问题名称>.noulnumber肯定判断的概率,范围为 0–1;接近 0.5 表示不确定。
usageobject实际输入、输出 token 用量。费用按这些计数结算。
请求说明
同步接口。 请求完成后返回 HTTP 200 OK,直接读取响应的 answers 中各问题的结构化结果。本接口无需获取任务 ID,也无需轮询任务状态。
| 必填请求头 | 取值 |
|---|---|
Authorization | Bearer YOUR_API_KEY,使用控制台创建的 API Key。 |
Content-Type | application/json |
读取判断结果
读取 answers.billing.noul,得到肯定判断的概率。0.97 表示肯定概率为 97%;接近 0 表示倾向否定,接近 0.5 表示不确定。
返回值是 0–1 的数字。应用根据自己的业务标准设置判断阈值,不能直接把它当作布尔值。
限时免费
Zev-1 当前限时免费,输入和输出均不收费。接口仍返回实际 token 用量,可在调用记录中查看。当前账户需保留正余额,免费调用不会扣减余额。
使用结果
通过问题名称读取 answers,再按 type 分支。判断阈值和人工复核阈值应依据你的业务评测确定,不能把示例概率当作服务准确率。
同一请求可以混合多种问题;为每个问题使用稳定、不同的名称。