如何开始使用 Jev

无需写代码

无需提供自己的 API key，就可以先在本站独立免费体验中测试材料和问题。你可以设置是／否判断标准，也可以定义 2–6 个选项。若要把 Jev 接入自己的应用，请使用下文单独说明的 TypeSafe 官方账号与 API 访问途径。

本站体验允许材料、问题、判断标准和选项合计最多 10,000 个字符，按 Unicode 码点计数。这是本站额度，不是 Jev 的上下文窗口。实时检查可能需要真人验证，达到用量或预算限制时会暂停。载入模板不会自动运行，也不会预填模型结果。

打开自定义编辑器 · 载入反馈分类模板

1、先确认适合你的访问途径

截至 2026 年 9 月 17 日，TypeSafe 公开网站提供候补名单。官方快速入门介绍了 Playground 和 API 的使用方式。文档页面可以访问，并不意味着每个账户都有模型访问权限。

• 尚未获得访问权限： 请加入 TypeSafe 官方网站上的候补名单。本站无法审批账户或发放 API 密钥。
• 账户已有访问权限： 打开 TypeSafe 控制台，按其中的 Playground 或 API 密钥流程操作。

账户开放范围和开通流程可能变化。请在官方控制台确认自己的账户状态。

2、先尝试一个范围明确的问题

在 Playground 中，用一条虚构的简短消息作为输入，提出一个 Noul 问题。例如，先输入一条要求回电的消息，询问发送者是否明确要求回电；再把输入改成含糊的求助消息，观察结果是否变化。

这是探索练习，不是准确率测试。先用两个形成对比的示例，可以帮助你检查：所写的问题是否表达了你原本希望区分的情况。

Jev 将所提供的信息称为 state，即输入的材料或上下文。它可以是字符串、JSON 对象或数组。处理更复杂的任务时，可使用具名字段区分消息、辅助记录和相关政策。输入格式

curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

4、按任务需要增加结构

下一步依赖类别时，使用 Choice；有合理的有序等级时，使用 Score；需要是非判断的概率时，使用 Noul。可以把针对同一份 state 的独立问题放在一起提交，再由应用处理各自的结果。

要继续实践，可以参照客服工单示例，了解如何把文档中的输出转成路由建议。

5、分开排查访问权限与请求问题

如果控制台登录未完成，请从正常入口重新打开官方控制台，确认使用的是已获权限的账户。不要为了修复浏览器登录问题而反复修改 API 请求。成功登录也不代表 API 密钥已经发放。如需账户帮助，请使用 TypeSafe 的官方支持渠道；切勿在公开报告中附上密钥或登录链接。

对于 HTTP 请求，在修改问题前，先检查状态码和错误响应体：

这些状态码均列于 API 参考文档。对于 429 或 529，请使用指数退避。SDK 默认已经会重试；增加外层重试循环前，要把这些尝试次数计算在内。

超时不等于否定答案。应设置总时限和有上限的尝试次数，再把未解决的任务交给审核流程。确保重试模型请求不会重复触发创建分派记录等下游操作。

6、排查出乎预期的答案

这些是本指南提出的调试建议。Score 指南解释了小数值的含义；限制页面链接了当前厂商说明，并单独标注社区观察。

jev-latest 别名可能指向更新的模型。测试时记录响应返回的模型标识符；如果重现结果很重要，请使用账户支持的具体版本标识符。模型别名

7、判断第一个工作流是否已经就绪

启用自动操作前，保留一小组预期决策样例，检查错误，并为实际工作流选择阈值。通过定价计算器估算输入 token 支出，再用比较指南判断哪些部分应继续交给其他工具。