[AIask]新增支持 Jev 模型，另有赛博鸡蛋自动发放。

[AIask]新增支持 Jev 模型，另有赛博鸡蛋自动发放。

请先注册： https://aiask.me/

使用方法：AIask.me 网站后台 -> API 密钥 -> 创建密钥 -> 名称自定义，类型选：OpenAi ，分组选：JEV 模型

费用（目前）：$0.063 / 1M 输入 token ，输出免费

一、curl 示例

curl https://aiask.me/v1/systemone \
  -H "Authorization: Bearer sk-你的 key" \
  -H "Content-Type: application/json" \
  -d '{
    "state": {"message": "导出按钮在 Safari 上会让设置页崩溃，Chrome 正常。", "source": "support_ticket"},
    "model": "jev-latest",
    "questions": {
      "is_bug": {
        "type": "noul",
        "instructions": "这是不是一个软件缺陷报告？"
      },
      "team": {
        "type": "choice",
        "instructions": "该分给哪个团队？",
        "criteria": {"frontend": "UI 、浏览器兼容性", "backend": "API 、数据库", "infra": "部署、可用性"}
      },
      "severity": {
        "type": "score",
        "instructions": "严重程度？",
        "criteria": ["仅外观问题", "功能受损但有变通办法", "阻塞且无变通办法"]
      }
    }
  }'

二、JEV 是什么

TypeSafe System One 不是聊天模型，是结构化判断模型。你给它一段素材（ state ）和若干道题（ questions ），它一次性返回每道题的概率化答案，没有自由文本、没有流式输出、没有 tool call 。

典型用途：工单分类、内容审核、RAG 段落筛选、LLM 输出兜底校验、意图路由、置信度分流。

与 OpenAI 协议的区别一览：

三、端点与鉴权

POST https://aiask.me/v1/systemone
Authorization: Bearer sk-你的-aiask-key
Content-Type: application/json

四、请求结构

{
  "state": "客户说运动鞋尺码发错了，想换成 10 码。",
  "model": "jev-latest",
  "questions": {
    "自定义题目 key": { "type": "noul|choice|score", "instructions": "...", "criteria": ... }
  }
}

三个字段都必填。questions 的 key 由你自己定义，响应会用同样的 key 返回答案 —— 这就是"结构化"的来源，不需要解析自由文本。

state 接受三种形态 **[官方文档]**：

"state": "我的卡被扣了两次款。"                                    // 字符串：单段文本
"state": {"message": "我的卡被扣了两次款。", "order_id": "A-104"}   // 对象：带字段名的记录（推荐）
"state": ["你好", "我的客户号是 TS1337 。", "卡被扣了两次款。"]        // 数组：消息序列

只接受文本，不支持图片 / 音频 / 视频。英文准确率最高，中文等其它语言支持但准确率会下降 [官方文档] —— 中文业务场景建议先小批量实测再上量。

原则：state 放事实和素材，questions 放要做的判断。两者不要混着写。

五、三种题型

1. noul —— 是非题，返回"是"的概率

{
  "type": "noul",
  "instructions": "客户是不是在要求转人工？",
  "criteria": {
    "true": "提到了之前的工单、尝试过联系、或说'我问过了'",
    "false": "没有任何过往联系的迹象"
  }
}

criteria 可选，只有 true / false 两个描述字段。返回：

{ "type": "noul", "noul": 0.93 }

noul 是 0~1 的概率值，表示"是"的可能性。注意 0.5 表示两种可能性各半，不是"中等程度"。noul 答案不带 confidence 字段。

2. choice —— 单选题，返回选项 + 完整概率分布

{
  "type": "choice",
  "instructions": "这条工单应该归哪个部门？",
  "criteria": {
    "returns": "换货、退款、错发或破损",
    "shipping": "物流状态、延迟、丢件",
    "billing": "扣费、发票、支付问题"
  }
}

criteria 是对象/映射（不是数组）：key 是选项名，value 是选项描述。描述可以写 null（选项名本身够清楚时）。最多 255 个选项 **[官方文档]**。返回：

{
  "type": "choice",
  "choice": "returns",
  "confidence": 0.88,
  "probabilities": { "returns": 0.88, "shipping": 0.09, "billing": 0.03 }
}

choice 是概率最高的那个，probabilities 全部选项加起来等于 1.0 。

3. score —— 打分题，返回有序量表上的位置

{
  "type": "score",
  "instructions": "这个 bug 有多严重？",
  "criteria": [
    "仅影响外观，功能正常",
    "功能受损或降级，但有变通办法",
    "阻塞性问题，无变通办法"
  ]
}

criteria 是数组（注意和 choice 不同），2~10 个等级，从低到高排列 **[官方文档]**。返回：

{
  "type": "score",
  "score": 1.3,
  "confidence": 0.54,
  "legend": { "0": "仅影响外观，功能正常", "1": "功能受损或降级，但有变通办法", "2": "阻塞性问题，无变通办法" },
  "probabilities": { "0": 0.0, "1": 0.7, "2": 0.3 }
}

score 不是整数，是各等级编号的概率加权平均（上例 1×0.7 + 2×0.3 = 1.3 ）。legend 是等级编号到描述的映射。

写 criteria 的要点 **[官方文档]**：等级描述要写得可对照素材（"功能受损但有变通办法"），不要写抽象词（"中等严重"）。一道题只评一个维度，多维度拆成多道题然后在自己代码里加权。

选型速查

六、完整响应

{
  "model": "jev-1.13.0",
  "answers": {
    "题目 key1": { ... },
    "题目 key2": { ... }
  },
  "usage": { "input_tokens": 360, "output_tokens": 39 }
}

一次请求可以问多道题，共用同一份 state 。这是省钱的关键：state 只计费一次，加题几乎不增加输入 token 。能合并就别拆成多次请求。

七、confidence 怎么用

confidence（ 0~1 ）由 probabilities 的集中程度算出来，只有 choice 和 score 有 **[官方文档]**。分布越集中越高，1.0 表示概率全压在一个结果上。

官方建议的三档分流 **[官方文档]**：

具体阈值要按业务定：官方示例用 0.5 作为兜底底线（低于此一律转人工），**破坏性操作要求 0.9+**，只读操作可以放宽。阈值要拿自己的数据实测后再调，别直接抄。

八、官方 SDK 接入

官方 SDK 可以直接用，只需把 base URL 指到 aiask.me 、key 换成本站 key，其余代码不用动。

Python

from typesafe_sdk import TypeSafeClient, Noul, Choice, Score

client = TypeSafeClient(
    api_key="sk-你的 aiask-key",
    base_url="https://aiask.me",      # 默认是 https://api.typesafe.ai
    model="jev-latest",
)

with client:
    resp = client.system_one(
        state="导出按钮在 Safari 上会让设置页崩溃。",
        questions={
            "team": Choice(
                instructions="该分给哪个团队？",
                criteria={"frontend": "UI 、浏览器兼容性", "backend": "API 、数据库"},
            ),
            "severity": Score(
                instructions="严重程度？",
                criteria=["仅外观问题", "功能受损但有变通办法", "阻塞且无变通办法"],
            ),
        },
    )
    print(resp.answers["team"].choice, resp.answers["team"].confidence)

• 环境变量走 TYPESAFE_API_KEY 和 TYPESAFE_BASE_URL（把后者设成 https://aiask.me 即可，代码零改动）
• 异步用 AsyncTypeSafeClient + async with，await client.system_one(...)
• 重试超时：RetryPolicy(max_retries=3, backoff_max=0.2, timeout=1.0)，可挂在 client 上也可以单次调用传
• 不想用 Noul() / Choice() 这些辅助类，也可以直接传原始字典：{"billing": {"type": "noul", "instructions": "关于账单吗？"}}

JavaScript / TypeScript

npm install @typesafe-ai/sdk    # 需要 Node.js 20+

import { TypeSafeClient, choice } from "@typesafe-ai/sdk";

const client = new TypeSafeClient({
  apiKey: "sk-你的 aiask-key",
  baseURL: "https://aiask.me",     // 默认 https://api.typesafe.ai
  defaultModel: "jev-latest",
  timeout: 10000,                  // 单次尝试超时，毫秒
});

const resp = await client.systemOne({
  state: { document: "我被重复扣款了，请尽快处理。" },
  questions: {
    category: choice("这条工单是关于什么的？", { billing: null, technical: null, other: null }),
  },
});

console.log(resp.answers.category.choice);

TypeSafeClientConfig 全部可选项 [官方文档]：apiKey、baseURL、defaultModel（默认 jev-latest）、timeout（默认 10000ms ）、retry、defaultHeaders、fetch、logger、logLevel（默认 warn）、dangerouslyAllowBrowser（默认 false ，别开，会把 key 暴露给页面用户）。

注意：base_url / baseURL 填站点根地址 https://aiask.me 就行，SDK 自己会拼 /v1/systemone。别填成 https://aiask.me/v1/systemone。

九、限制

官方说明速率限制会因需求波动动态调整，可能不另行通知。本站还叠加自己的分组并发、RPM 、配额限制。

十、错误码与排错

422 的三种常见原因 **[已实测]**：

1. body 不是合法 JSON ，或为空
2. model 不是 jev-*（比如误传 gpt-5.4）—— 报 model must be a jev model (e.g. jev-latest)
3. 缺 questions，或 questions 不是对象 —— 报 questions is required

排错顺序建议：

1. 先 GET /v1/models 确认 key 能看到 jev 模型 —— 看不到说明分组白名单或平台不对
2. 后台 → 账号管理 → 对应账号点"测试连接"，模型选 jev-latest，会直接打上游 /v1/systemone 并回显 model / noul / usage [已实测]
3. 后台 → 使用记录，确认 inbound_endpoint 和 upstream_endpoint 都是 /v1/systemone