SYSTEM ONE / 开发者文档
System One 文档
将应用上下文转成类型明确的选项、评分和概率。用开源 SDK 连接你选择的服务，通过 HTTP 调用我们的托管 API，或将两者结合使用。
SDK 与托管 API 是两个独立产品。通过 SDK 直连其他服务时，使用该服务自己的凭证与计费。
// System One SDK
npm install @system-one-ai/core@0.8.0 \
@system-one-ai/transport-fetch@0.8.0
// System One API
POST /v1/systemone
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json安装命令与 HTTP 入口，本页不会执行推理。
接入指南
通过 SDK 调用托管 API
安装客户端，配置地址与密钥，发送第一个类型化请求。
用 Clairic 抽取类型化字段
使用公开模型名 clairic 调用 extract({ state, fields })。含发票示例、字段类型、图片抽取和托管 HTTP 请求体。
选择与比较模型
查看当前可用模型、价格与限制，用同一个任务比较结果。
选择问题类型
定义 Choice、Score 和 Noul 问题，理解它们的类型化结果。
接入智能体
选择边界明确的决策任务，保留权限、动作执行与恢复的控制权。
Cursor、Claude Code、Codex 接入 System One 教程
安装 Agent Skill，并粘贴分类、工具路由和完成检查的提示词。
跟踪 API 变更
区分 HTTP 协议、SDK 包和模型版本。
处理请求重试
恢复已完成的答案，区分处理中、失败和已重放的请求。
估算积分用量
估算请求消耗、购买预付积分，并处理不确定的扣费。
了解数据流向
了解提交内容、请求记录和响应保留方式。
处理 API 错误
先读取错误分类与请求 ID，再决定是否重试。