Jev模型网页端调用工具是通过Web API调用TypeSafe AI在线服务的轻量方案，无需安装插件或配置本地模型，只需注册账号获取API Key，按规范构造state和questions请求体，选择前端直连或后端代理方式调用即可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Jev 模型网页端调用工具不是独立安装的浏览器插件或桌面程序，它本质是通过 Web API 调用 TypeSafe AI 提供的在线服务。你不需要下载 exe 或 dmg 文件，也不用配置本地模型权重——只需注册账号、获取密钥、构造请求即可在网页环境（或任何支持 HTTP 的前端）中直接使用。
一、注册账号并拿到 API Key
访问官方控制台：https://console.typesafe.ai，用邮箱注册新账号。新用户自动赠送 5 美元额度（约 1.2 亿输入 token）。进入 API keys 页面（路径：Settings → API keys），点击 “Create new key”，密钥仅显示一次，请立即复制保存。建议设为环境变量（如 TYPESAFE_API_KEY），避免硬编码。
二、网页端调用的两种主流方式
你可以选择纯前端直连（需处理 CORS）或后端代理（更推荐）：
-
方式① 前端 fetch（开发调试可用）：确保你的网页托管在支持 CORS 的域名下（如 Vercel/Netlify），或临时用本地 server 启动（
npx serve）。发送 POST 请求到https://api.typesafe.ai/v1/systemone，Header 必须包含：Authorization: Bearer <your_api_key>Content-Type: application/json - 方式② 后端代理（生产推荐）：用 Express、Flask 或 Cloudflare Workers 写一个轻量代理接口，把前端请求转发给 Jev API。这样可隐藏密钥、统一加日志、控制频率，并绕过浏览器 CORS 限制。
三、构造合法的请求体（关键！不能错）
Jev 不接受自由 prompt，必须严格按结构传参：
- state：字符串类型，描述当前上下文（如用户输入、页面文本、工单内容），≤ 32K token，建议精简到 2048 字符以内；
-
questions：数组，每个元素必须含
type和name字段； -
type只能是"choice"（单选）、"score"（打分）、"noul"（是非判断，注意不是"bool"）； - 例如判断客服工单类型：
{"state": "用户说：订单号 #88291 一直没发货，我要退款", "questions": [{"type":"choice","name":"category","options":["shipping","refund","technical"]}]}
四、处理返回结果
响应是标准 JSON，结构清晰、无需解析：
- 成功时返回类似：
{"category":"refund","category_confidence":0.94,"probabilities":{"shipping":0.02,"refund":0.94,"technical":0.04}} -
_confidence字段表示模型对本次判断的校准置信度（非 softmax 概率），建议业务侧设定阈值（如>0.8才采纳）； - 失败时会返回明确错误码（如
400 Bad Request表示字段名拼错、401表示密钥无效），不静默失败。
