机器文档
Jev / System One 调用说明
人读长文在 /jev。本页给程序：怎么鉴权、请求长什么样、三套调用面哪里不能互抄。Aijiau POST /v1/systemone 现已上线。api.aijiau.com/jev/docs 当时是 404，应 301 到这里。
鉴权
打 Aijiau 网关用本站身份，不要夹带 TypeSafe 或其它上游密钥。
- 浏览器试跑：已登录会话，走控制台 Playground。
- 程序调用：在 api.aijiau.com 创建 sk-...，请求头 Authorization: Bearer sk-...。
- 不要把站外 / 上游密钥写进 Aijiau 的 POST。
noul | choice | score
Aijiau 官方入口是 POST /v1/systemone，body 里 model 填 jev，带 state 和 questions 映射。这条路由现已上线。问题类型与 TypeSafe HTTP 相同；默认模型 id 不同。
- Aijiau（现网已上线）
- POST https://api.aijiau.com/v1/systemone
model: jev
现网已上线 · 0.2.1-aijia.99 · SHA 8ff42e9 - TypeSafe（协议参照）
- POST https://api.typesafe.ai/v1/systemone
model: jev-latest
上游协议参照
| type | 问题字段 | 答案形状 |
|---|---|---|
| noul | type + instructions (+ optional true/false criteria) | { type: "noul", noul } |
| choice | type + instructions + criteria map (max 255) | { type: "choice", choice, probabilities, confidence } |
| score | type + instructions + criteria array (2–10 levels) | { type: "score", score, legend, probabilities, confidence } |
答案形状与 Choice 最多 255 项、Score 2–10 档摘自 TypeSafe HTTP API（docs.typesafe.ai/api）。Aijiau 现网 curl 用同一套 type 名。
三调用面别混
同一份决策至少有四条路。字段名不一样，价也不一样。抄错一行，请求会废。
| 调用面 | 入口 | 模型 / 密钥 | Noul 写法 | Noul 答案 | 价（各自来源） |
|---|---|---|---|---|---|
| Aijiau HTTP | POST https://api.aijiau.com/v1/systemone (live) | jev | noul | answers.*.noul | ¥0.6 / 1M input · output free |
| TypeSafe HTTP | POST https://api.typesafe.ai/v1/systemone | jev-latest | noul | { type, noul } | $0.042 / 1M input |
| Vercel AI SDK | experimental_evaluate | typesafe-ai/jev | boolean | probability | $0.042 / 1M (Gateway cites TypeSafe) |
| LangChain | TypeSafeClassifier | TYPESAFE_API_KEY | Noul() | response.nouls[id].noul | TypeSafe key / list price |
不要把 Vercel 的 boolean 写进 Aijiau JSON，也不要把 Aijiau 的 noul 写进 experimental_evaluate()。LangChain 读 .noul。TypeSafe HTTP 默认别名是 jev-latest；Aijiau 公开模型 id 是 jev。
独立可抓取页：三调用面别混 /jev/surfaces错误码
下面只复述 TypeSafe HTTP API 已公布的状态码。不要把它们当成 Aijiau 网关的完整目录。
| HTTP | 名称 | TypeSafe 说明 |
|---|---|---|
| 401 | Unauthorized | Missing or invalid API key. Check the Authorization header. |
| 422 | Unprocessable Entity | The request body failed validation — for example a missing required field or a malformed question. |
| 429 | Too Many Requests | You have exceeded your rate limit. Back off and retry after a short delay. |
| 529 | Overloaded | TypeSafe is temporarily overloaded. Retry after a short delay. |
Ops 在现网 api.aijiau.com 核过：无密钥 → 401（不是 404）。有效 sk-... 打 noul / choice / score → 200。用 POST /v1/chat/completions 打 model jev 返回 400。不要在本页发明完整 4xx/5xx 列表。429 / 529 按 TypeSafe 文档做短延迟重试。
计费
Aijiau 对客价（现网产品页，2026-09-20）：输入 ¥0.6 / 1M tokens，输出免费。TypeSafe 标价 $0.042 / 1M input 出自其文档与产品页，不是本站测速。两套价不要合成一张表。密钥、账单、用量在 api.aijiau.com 控制台。
第一次调用
先打开 api.aijiau.com 控制台拿 sk-...，再打通下面这条 curl。POST /v1/systemone 现已上线。协议参照 TypeSafe POST https://api.typesafe.ai/v1/systemone。不要用 POST /v1/chat/completions 打 model jev（400）。数字是形状示例，不是 SLA。不编造 QPS。
curl · POST /v1/systemone · live
# Aijiau System One 现网已上线（0.2.1-aijia.99，SHA 8ff42e9）
# POST https://api.aijiau.com/v1/systemone model: jev
# 协议参照：POST https://api.typesafe.ai/v1/systemone
# 不要用 POST https://api.aijiau.com/v1/chat/completions 打 model jev，现网返回 400
# 把 sk-... 换成你在 Aijiau「API 密钥」里创建的密钥
curl -sS -X POST https://api.aijiau.com/v1/systemone \
-H "Authorization: Bearer sk-你的Aijiau密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "jev",
"state": "用户反馈：付款已经失败三天，订单 ORD-2024-1234，金额 $299，急需处理。",
"questions": {
"urgent": {
"type": "noul",
"instructions": "这个问题是否紧急？"
},
"team": {
"type": "choice",
"instructions": "应该由哪个团队处理？",
"criteria": {
"billing": "支付、退款、账单",
"technical": "技术故障、API 错误",
"sales": "销售咨询、价格"
}
},
"frustration": {
"type": "score",
"instructions": "用户沮丧程度",
"criteria": ["平静", "有些不满", "非常愤怒"]
}
}
}'