Jev API：集成时不要与聊天接口混淆

TypeSafe 直连 API

文档介绍的是带 Authorization: Bearer 请求头的 POST https://api.typesafe.ai/v1/systemone。请求包含模型、状态（state）和问题映射（questions）。S08 文档中的示例使用别名 jev-latest；截至2026年9月23日，它和 jev-preview 都指向 jev-1.13.0。为了获得稳定的结果，我们建议指定固定版本。S01

示例请求体可以用问题构建器生成。它并不是已发生的付费调用的记录。

通过 OpenRouter 接入

OpenRouter 的文档给出了决策端点 POST https://openrouter.ai/api/alpha/decisions 和标识符 typesafe/jev-1.13。因此，只在现有的聊天适配器中改写模型名称是不够的。S17

JEV.sk 推荐的适配器设计

把服务商与您内部的响应 schema 分离开。设置超时，校验响应，处理错误，并把不明确的结果送去审核。将问题定义的版本与所用模型一起保存。记录用量即可，不要无谓地保存完整的私人消息。

JEV.sk 不调用实时 API：它解释原理，并直接在浏览器中生成示例 JSON。实时调用需要单独的服务器端端点、预算、防滥用限制，并清楚告知访问者其文本会被发送给第三方。

绝不把密钥放在浏览器里

对于将来的实时演示，我们建议由服务器管理密钥。不要把它写进 JavaScript、HTML、URL、代码仓库或日志。用户应事先知道自己面对的是演示还是真实服务。

服务中断时，应用不得编造成功的结果，而应返回易懂的错误信息，或提供安全的替代流程。