System One
面向 Jev 应用的类型化决策 API。
System One 通过原生决策端点提供 Jev 服务，并配有账户、API 密钥、预付积分和浏览器 Playground。项目客户端为 @system-one-ai/sdk@0.3.0，官方 @typesafe-ai/sdk@0.6.0 也作为独立兼容验证客户端。维护中的 HTTP 契约为 typesafe-2026-09-18。
提交一份共享的 state（状态） 和一组命名的 questions（问题），获取选项、评分和概率。后续动作由你的应用控制，包括是否调用独立的规划模型。
开始构建
| 指南 | 内容 |
|---|---|
| SDK 快速开始 | 创建密钥，发送包含三种问题的请求。 |
| 决策原语 | 理解概率分布、加权评分和 P(true)。 |
| API 参考 | 使用原生 HTTP 协议，了解平台限制。 |
| 幂等与重试 | 恢复已完成的响应，避免重复推理。 |
| 积分与计费 | 估算请求消耗，了解预付积分包。 |
| 数据处理 | 了解存储、保留期限与上游处理。 |
| 部署指南 | 将主应用和文档部署到 Cloudflare Workers。 |
统一的公开接口
为 SDK 设置 baseURL: 'https://your-deployment.example.com/v1' 和 System One API 密钥，客户端就会调用 POST /v1/systemone。请用部署运营者提供的地址替换示例域名；文档站可能运行在独立的 Worker 上。
可提供非全空白的模型别名或固定版本 ID。显式模型原样发送给 TypeSafe；省略时使用部署默认值，未配置则为 jev-latest。别名可能随上游更新而变化。GET /v1/models 需要平台密钥，返回真实 TypeSafe { models } 正文，不是匿名能力列表或版本白名单。
X-System-One-Response-Mode: typesafe-native 表示保留有效 TypeSafe 成功 JSON 文本、状态与扩展字段，不添加计费、ID、warnings 或 rounding。平台积分与 ID 读取响应头，API 参考说明原生错误和安全例外。OpenRouter 是显式 openrouter-adapted 路径，升级前缓存标记 legacy-cache，二者都不承诺原始 TypeSafe 字节保真。
如何理解结果
概率是模型估计，不是动作执行授权，也不保证单次判断正确。score 基于有序评分标准，可以是小数。TypeSafe 原生 Choice 包含分布与 confidence，Score 还包含 legend；缺失用量保持未知。原生 state 必填但可为 null，instructions 可省略或为 null，Noul criteria 可为 null，最终由上游决定是否接受。上游未配置或调用失败时，平台不会生成虚构答案。
基于 TinyShip
主站保留 TinyShip 模块化的认证、数据库、支付和积分账本。TanStack Start 承载产品功能；本 Fumadocs 应用导出中英文静态文档。参阅部署架构和 System One SDK 仓库。