---
title: "System One 模型， 一个 API 接入。"
description: "通过统一的 HTTP 接口调用 Jev，获取结构化的选项、评分和概率。API 密钥、调用记录与积分计费，在一个平台管理。"
canonical: "https://system-one.dev/zh-CN/api"
last-updated: "2026-09-20"
language: "zh-CN"
---

# System One 模型， 一个 API 接入。

通过统一的 HTTP 接口调用 Jev，获取结构化的选项、评分和概率。API 密钥、调用记录与积分计费，在一个平台管理。

HTTP + JSON · API 密钥认证 · 预付积分

## 发起第一个 HTTP 请求

在服务端设置 SYSTEM_ONE_API_KEY，向上方地址发送请求。成功完成的评估会消耗账户积分。

```sh
curl 'https://system-one.dev/v1/systemone' \
  -H "Authorization: Bearer $SYSTEM_ONE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "jev-latest",
    "state": { "message": "I was charged twice." },
    "questions": {
      "team": {
        "type": "choice",
        "instructions": "Who should handle this?",
        "criteria": {
          "billing": "Payments and refunds",
          "support": "Technical issues"
        }
      }
    }
  }'
```
## 三种原语，表达不同的判断

将上下文作为 State，定义要评估的问题。一次请求可组合 Choice、Score 和 Noul，每个问题都针对同一份上下文独立评估。
## Choice：从候选项中选择

定义一组候选项，获得选中的选项、各选项的概率和置信度。
## Score：按标准评分

定义有序的等级描述，获得概率加权的分数、各等级的概率和置信度。分数可以落在两个等级之间。
## Noul：判断「是」的概率

提出一个是非问题，获得 0 到 1 之间的 P(true)。需要布尔值时，在代码中设定判断阈值。
## 开始调用 System One

### 创建密钥

在控制台创建 API 密钥，保存到服务端环境。完整密钥只展示一次。

### 发起请求

复制 cURL 示例，或使用自己的 HTTP 客户端，无需安装 SDK。

### 查看用量

在控制台查看请求状态、积分消耗与账户余额。

## 认证

登录或注册账户，完成部署要求的邮箱验证，然后进入 API 密钥页面创建命名密钥。完整密钥仅显示一次，请复制到服务端环境变量或密钥管理服务。网站 Playground 使用登录会话，外部应用使用平台密钥。

[认证](https://system-one.dev/zh-CN/auth.md)
## 失败与重试记账

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

## 从这里开始

- [开发文档](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)