Jev API 调用
接入状态:Mixtoken 已公开 jev-1.13,通过 /v1/systemone 调用。请显式填写该模型 ID。
了解 Jev
Jev,是判断模型,不是聊天模型。给它一段文字和一个问题,它直接回答归哪一类、打几分、是还是否,结果程序可以直接使用。例如把“订单重复扣款”的反馈分给账单团队,或给一条评论打分。
它使用专用判断协议,与 OpenAI Chat Completions 接口不兼容,也不能作为 Codex、Claude Code 的对话模型。
获取 API Key
在 控制台 获取 Mixtoken API Key,将它保存到 MIXTOKEN_API_KEY 环境变量。已有 Key 可直接使用。
直接调用接口
请求地址:POST https://api.mixtoken.ai/v1/systemone,请求头 Authorization: Bearer <Mixtoken API Key>,请求体使用 Jev 判断任务结构。下面把一条“重复扣款”的反馈分到 billing、technical 或 other。示例使用英文输入,便于先确认调用;中文场景需用实际数据验证效果。
curl --fail-with-body 'https://api.mixtoken.ai/v1/systemone' \
-H "Authorization: Bearer $MIXTOKEN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "jev-1.13",
"state": "I was charged twice for the same order.",
"questions": {
"department": {
"type": "choice",
"instructions": "Which team should handle this customer message?",
"criteria": {
"billing": "Charges, payments and refunds",
"technical": "Bugs and integration issues",
"other": "Other requests"
}
}
}
}'
读取结果
以下仅为返回格式示意,实际结果和概率以调用返回为准:
{
"answers": {
"department": {
"type": "choice",
"choice": "billing",
"probabilities": { "billing": 0.96, "technical": 0.01, "other": 0.03 },
"confidence": 0.92
}
}
}
answers.department.choice 是选中的分类。probabilities 包含各个分类的概率;confidence 表示模型对这次分类的置信度。
选择判断类型
| 类型 | 提交什么 | 读取什么 |
|---|---|---|
choice 分类 |
criteria 为“选项名 → 说明”的对象 |
choice、probabilities、confidence
|
score 评分 |
criteria 为按分值从低到高排列的说明数组 |
score、legend、probabilities、confidence;分数可能有小数 |
noul 是非判断 |
问题描述,可选 criteria.true 和 criteria.false
|
noul 为 0–1 的数值,越接近 1 越倾向“是” |
三种判断类型都通过 questions 定义;请以 Mixtoken 接口校验和实际响应为准。
查看价格与限制
-
jev-1.13已进入 Mixtoken 公开模型目录;模型可用性与价格以控制台为准。 -
state加最长单个问题最多 32K tokens;state加所有问题合计最多 64K tokens。 -
choice最多 255 个选项;score使用 2–10 档评分说明。 - 请求不使用
messages、stream、temperature或max_tokens。
排查调用问题
- 401:检查 Key 是否完整、是否有效,以及
Authorization: Bearer请求头。 - 400:检查
state、questions、问题类型和criteria的格式,错误信息会指出具体字段。 - 404:核对请求路径是否为
/v1/systemone。 - 429:请求超过限流,等待片刻后按指数退避重试;官方 SDK 默认会自动重试。