跳至主要内容

System One API。 一个端点。

通过 System One API 端点调用 System One 模型,完成意图分类、打分与是否判断。返回结构化选项、评分与概率;如何执行由你的应用决定。

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

https://system-one.dev/v1
cURL · POST /v1/systemone
curl 'https://system-one.dev/v1/systemone' \  -H "Authorization: Bearer $SYSTEM_ONE_API_KEY" \  -H 'Content-Type: application/json' \  --data '{    "state": { "message": "I was charged twice." },    "questions": {      "team": {        "type": "choice",        "instructions": "Who should handle this?",        "criteria": {          "billing": "Payments and refunds",          "support": "Technical issues"        }      }    }  }'

开始调用 System One

  1. 1

    创建密钥

    在控制台创建 API 密钥,并保存到服务器环境变量。完整密钥只显示一次。

  2. 2

    发送请求

    复制 cURL 示例,或使用你的 HTTP 客户端。无需安装 SDK。

  3. 3

    查看用量

    在控制台查看请求状态、积分扣费与剩余余额。

在服务器上设置 SYSTEM_ONE_API_KEY,然后向上方端点发送请求。成功的评估会消耗账户积分。

API 文档

结构化决策的三种原语

将上下文作为 state 发送,并定义要评估的问题。可在同一请求中组合 Choice、Score、Noul;各问题针对同一 state 独立评估。

共享状态

“这笔订单被扣了两次款。请退还重复支付的部分。”
state.message
示意示例 · 非实时响应

Choice:选择一个选项

定义一组选项。获得选中项、各选项概率与置信度。

01
billing账单与退款
0.92
support技术支持
0.06
sales销售
0.02
示例答案answers.department.choice → "billing"
在 Choice、Score 与 Noul 之间选择

这些数值仅示意响应格式。在 Playground 用自己的输入可得到真实结果。

在线试用此示例

对比 Clairic 与决策模型

下列为可在 system-one.dev 调用的全部决策模型(含 Clairic)。各页说明可读输入、单次可问问题数,以及每次调用消耗的积分。

Jev

1×

TypeSafe Jev 结构化决策。

  • 每问题每 4KB 1 积分
  • 最多 32 个问题 · 每请求 64KB
  • 输入:文本与 JSON
  • 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
  • 单选:最多 255 个选项;Score:2–10 级
  • 问题 ID:最多 128 个字符
  • state 可为 null;instructions 可选且可为 null。问题 ID 不可为空。

模型页

Clef Flash

3×

面向量大、对成本敏感的分类与路由。

  • 每问题每 4KB 3 积分
  • 最多 32 个问题 · 每请求 13MB
  • 输入:文本、JSON 与图片(PNG、JPEG、WebP)
  • 图片:最多 4 张 · 每张 4MB · 合计 8MB
  • 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
  • 单选:最多 255 个选项;Score:2–10 级
  • 问题 ID:最多 100 个字符
  • state 不能为 null。每个问题需要非空的 string、object 或 array 说明。ID 仅可用 A–Z、a–z、0–9、_、.、-。Score 的 criteria 不能为 null;Noul 的 criteria 须省略或仅为含 true/false 键的对象。不支持额外问题字段。

模型页

Clef

6×

面向复杂分类与评分的结构化决策模型。

  • 每问题每 4KB 6 积分
  • 最多 32 个问题 · 每请求 13MB
  • 输入:文本、JSON 与图片(PNG、JPEG、WebP)
  • 图片:最多 4 张 · 每张 4MB · 合计 8MB
  • 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
  • 单选:最多 255 个选项;Score:2–10 级
  • 问题 ID:最多 100 个字符
  • state 不能为 null。每个问题需要非空的 string、object 或 array 说明。ID 仅可用 A–Z、a–z、0–9、_、.、-。Score 的 criteria 不能为 null;Noul 的 criteria 须省略或仅为含 true/false 键的对象。不支持额外问题字段。

模型页

Clef Omni

4×

读文字、JSON 和图片,给出选项、评分或是非判断。

  • 每问题每 4KB 4 积分
  • 最多 32 个问题 · 每请求 13MB
  • 输入:文本、JSON 与图片(PNG、JPEG、WebP)
  • 图片:最多 4 张 · 每张 4MB · 合计 8MB
  • 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
  • 单选:最多 255 个选项;Score:2–10 级
  • 问题 ID:最多 100 个字符
  • state 不能为 null。每个问题需要非空的 string、object 或 array 说明。ID 仅可用 A–Z、a–z、0–9、_、.、-。Score 的 criteria 不能为 null;Noul 的 criteria 须省略或仅为含 true/false 键的对象。不支持额外问题字段。

模型页

Decider

1×

读文字和 JSON,给出选项、评分或是非判断。

  • 每问题每 4KB 1 积分
  • 最多 32 个问题 · 每请求 64KB
  • 输入:文本与 JSON
  • 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
  • 单选:最多 255 个选项;Score:2–10 级
  • 问题 ID:最多 128 个字符
  • state 可为 null;instructions 可选且可为 null。问题 ID 不可为空。

模型页

Clairic

2×

从文本、JSON 和图片里取出类型化值的抽取模型。

  • 提供方: system-one.dev
  • 每 4KB 输入 2 积分
  • 字段数量不影响价格。输入含 state、字段说明与图像。输出不计费。

模型页

价格以积分计。Token 用量仅供参考;实际按模型、问题数与 4KB 块计费。

模型与请求限制

在同一共享状态下最多评估 32 个问题。文本与 JSON 模型默认请求上限 64KB。支持图像的模型可在发布限额内接受内联 PNG、JPEG、WebP,网关上限 13MB。各模型能力与限额以实时目录为准。

GET /v1/models 为公开接口,返回当前已发布模型、价格与限额。推理仍需平台 API 密钥。

API 文档

按用量计费的积分定价

按模型、问题数量与输入大小计费。运行评估前可在 Playground 估算积分消耗。

questions × max(1, ⌈request bytes / model block size⌉) × model rate

API 定价

使用 TypeScript SDK

用 choice()、score()、booleanQuestion() 定义问题。使用同一 API 密钥连接,在应用中获得类型化结果。

了解 SDK

将 SDK 连接到托管 API

发起第一次 HTTP 请求

在服务器上设置 SYSTEM_ONE_API_KEY,然后向上方端点发送请求。成功的评估会消耗账户积分。

获取 API 密钥