---
title: "System One 开发文档"
description: "了解决策原语、集成 SDK，或发起第一个 API 请求。"
canonical: "https://system-one.dev/zh-CN/docs"
language: "zh-CN"
---

# System One 开发文档

了解决策原语、集成 SDK，或发起第一个 API 请求。

## System One SDK

安装 TypeScript SDK、连接模型服务，定义问题并处理类型明确的结果。

[阅读 SDK 文档](https://docs.system-one.dev/zh-CN/docs/sdk)
## System One API

首次 HTTP 请求、身份认证、模型、限制、错误与积分计费。

[阅读 API 文档](https://docs.system-one.dev/zh-CN/docs/api)
## 将 SDK 连接到 System One API

按托管 API 接入指南配置服务地址、平台密钥和重试策略。

[将 SDK 连接到托管 API](https://docs.system-one.dev/zh-CN/docs/getting-started)
## 何时使用 System One

当应用需要在命名选项间路由请求、按照有序量表评分，或根据 P(true) 概率选择分支时，使用 System One。先定义允许的答案空间，将业务动作保留在应用代码中；不确定的决策可以交给人工或推理模型处理。在依赖阈值之前，使用具有代表性的输入验证效果。
## 响应元数据

X-System-One-Credits 表示本次扣费，X-Request-Id 用于平台追踪，X-Idempotency-Replayed 表示重放，X-System-One-Response-Mode 表示传输模式。安全的供应商原生 JSON 与扩展字段会被保留，平台元数据不会插入供应商响应正文。
## 失败与重试记账

推理前预留积分，记录为失败的推理会返还预留积分。在重放记录仍可用期间，相同 Idempotency-Key 与相同请求正文的成功重放不会再次推理或扣费。同键不同输入会被拒绝。超时或结果不确定时，先检查请求用量并保留原键，再决定是否重试；对账可能处于待处理状态，不能在记录确认前假定已退款。
## 请求限制

纯文本模型请求上限为 65536 字节，支持图片的 Clef 模型最高为 13 MiB；所选模型当前限制可能更严格，以 GET /v1/models 为准。最多 32 个问题、255 个 Choice 选项、10 个 Score 层级，嵌套深度不超过 32。模型目录需要平台密钥，但不消耗推理积分。
## 决策模型对比

托管模型返回 choice、score 和 noul 决策。文本、JSON 和图片输入能力由实时目录逐模型声明，不通过模型名称推断。

当前没有可用的托管模型，请查看实时模型目录。

这里是零售积分价格，不是上游 Token 价格。Token 用量仅供参考；实际按所选模型、问题数量与字节计费块扣除积分。

原生 HTTP 服务商保留自由填写的模型别名，按每个问题、每个计费块 1 积分计费。托管 Workers AI 模型目录不会改变这些服务商的能力。

## 从这里开始

- [开发文档](https://system-one.dev/zh-CN/docs)
- [TypeScript SDK](https://system-one.dev/zh-CN/sdk)
- [API 参考](https://system-one.dev/zh-CN/api)
- [认证](https://system-one.dev/zh-CN/auth.md)
- [定价](https://system-one.dev/zh-CN/pricing)
- [OpenAPI 定义](https://system-one.dev/openapi.json)
- [智能体接入指南](https://system-one.dev/zh-CN/skill.md)
- [关于](https://system-one.dev/zh-CN/about)
- [联系](https://system-one.dev/zh-CN/contact)
- [SDK 源码](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)