Jev API 入门：从密钥到第一条请求

先拿到访问权限

在 TypeSafe 官方控制台创建密钥，并把它保存在服务端环境变量 TYPESAFE_API_KEY。不要把密钥放进网页脚本、截图或可分享链接。可用性和申请步骤以官方控制台当天显示为准。

请求形状

向官方端点 POST 一个 JSON 对象：state 是当前事实，model 使用官方文档的模型名，questions 是问题 ID 到类型化问题的映射。下面的示例是合成客服消息，可以直接替换为脱敏样本。

检查返回值

先确认 HTTP 状态和 answers 中的问题 ID，再查看 Choice 的 choice、probabilities、confidence。低置信度时只排入人工队列。不要把 confidence 当成已验证的准确率。

第一次运行前，逐项检查

用服务端环境变量保存密钥；安装官方 SDK 时核对 Python 版本；准备一条不含个人资料的样本；确认问题 ID 与候选键名固定；让接口超时、限流或返回字段缺失时进入人工路径。密钥绝不能进浏览器源代码，本站实验室也不会接收密钥。

读懂下面的示例，而不是只复制

state 是一次判断看到的事实；model 表示选择的模型版本或别名；questions 的键 team 是业务代码稍后读取答案的 ID。Choice 的 criteria 键是可处理的选项标识，说明文字决定边界。若结果为 review 或字段缺失，业务代码应停止自动分流。

从单条请求迈向批量验证

第一次请求成功只证明网络、权限和格式通了。把同一套问题用于一批脱敏且人工标注的工单，记录原始标签、模型输出、请求 ID、耗时与最终动作。对比错误类型后再调整候选定义；每次改问题或模型都要重新跑回归集。

示例请求 · HTTP

这是设计草案，不是 Jev 的实际回答或准确率测试。

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"My parcel says delivered, but nothing arrived.","model":"jev-latest","questions":{"team":{"type":"choice","instructions":"Which team should handle this request?","criteria":{"shipping":"Delivery or missing package","billing":"Payment or charges","other":"None of the above"}}}}'

Python SDK

from typesafe_sdk import Choice, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        state="My parcel says delivered, but nothing arrived.",
        questions={
            "team": Choice(
                instructions="Which team should handle this request?",
                criteria={
                    "shipping": "Delivery or missing package",
                    "billing": "Payment or charges",
                    "other": "None of the above",
                },
            )
        },
    )
    answer = response.answers["team"]
    print(answer.choice, answer.confidence)

可以运行的 Python 示例

先在服务端环境中设置 TYPESAFE_API_KEY，再安装官方 SDK：pip install typesafe-sdk。以下代码按官方快速开始文档的 SDK 形状编写；运行前请在官方文档核对版本与权限。