Zev-1

定义判断、选项或评分标准,获得程序可直接使用的结构化结果。

POSThttps://api.zleap.com/v1/systemone同步接口
问题类型

判断请求参数

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,也无需轮询任务状态。

必填请求头取值
AuthorizationBearer YOUR_API_KEY,使用控制台创建的 API Key。
Content-Typeapplication/json

读取判断结果

读取 answers.billing.noul,得到肯定判断的概率。0.97 表示肯定概率为 97%;接近 0 表示倾向否定,接近 0.5 表示不确定。

返回值是 0–1 的数字。应用根据自己的业务标准设置判断阈值,不能直接把它当作布尔值。

限时免费

Zev-1 当前限时免费,输入和输出均不收费。接口仍返回实际 token 用量,可在调用记录中查看。当前账户需保留正余额,免费调用不会扣减余额。

使用结果

通过问题名称读取 answers,再按 type 分支。判断阈值和人工复核阈值应依据你的业务评测确定,不能把示例概率当作服务准确率。

同一请求可以混合多种问题;为每个问题使用稳定、不同的名称。