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。示例使用英文输入,便于先确认调用;中文场景需用实际数据验证效果。

bash
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"
      }
    }
  }
}'

读取结果

以下仅为返回格式示意,实际结果和概率以调用返回为准:

json
{
  "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 默认会自动重试。
准备好了?三步即可开始登录控制台 · 购买额度 · 创建 API Key