System One API。
一个端点。
通过 System One API 端点调用 System One 模型,完成意图分类、打分与是否判断。返回结构化选项、评分与概率;如何执行由你的应用决定。
HTTP + JSON · API 密钥认证 · 预付积分
https://system-one.dev/v11curl 'https://system-one.dev/v1/systemone' \2 -H "Authorization: Bearer $SYSTEM_ONE_API_KEY" \3 -H 'Content-Type: application/json' \4 --data '{5 "state": { "message": "I was charged twice." },6 "questions": {7 "team": {8 "type": "choice",9 "instructions": "Who should handle this?",10 "criteria": {11 "billing": "Payments and refunds",12 "support": "Technical issues"13 }14 }15 }16 }'
开始调用 System One
- 1
创建密钥
在控制台创建 API 密钥,并保存到服务器环境变量。完整密钥只显示一次。
- 2
发送请求
复制 cURL 示例,或使用你的 HTTP 客户端。无需安装 SDK。
- 3
查看用量
在控制台查看请求状态、积分扣费与剩余余额。
在服务器上设置 SYSTEM_ONE_API_KEY,然后向上方端点发送请求。成功的评估会消耗账户积分。
API 文档结构化决策的三种原语
将上下文作为 state 发送,并定义要评估的问题。可在同一请求中组合 Choice、Score、Noul;各问题针对同一 state 独立评估。
共享状态
“这笔订单被扣了两次款。请退还重复支付的部分。”
state.message示意示例 · 非实时响应 Choice:选择一个选项
定义一组选项。获得选中项、各选项概率与置信度。
01示例答案answers.department.choice → "billing"
在 Choice、Score 与 Noul 之间选择对比 Clairic 与决策模型
下列为可在 system-one.dev 调用的全部决策模型(含 Clairic)。各页说明可读输入、单次可问问题数,以及每次调用消耗的积分。
TypeSafe Jev 结构化决策。
- 每问题每 4KB 1 积分
- 最多 32 个问题 · 每请求 64KB
- 输入:文本与 JSON
- 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
- 单选:最多 255 个选项;Score:2–10 级
- 问题 ID:最多 128 个字符
- state 可为 null;instructions 可选且可为 null。问题 ID 不可为空。
模型页
面向量大、对成本敏感的分类与路由。
- 每问题每 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 键的对象。不支持额外问题字段。
模型页
面向复杂分类与评分的结构化决策模型。
- 每问题每 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 键的对象。不支持额外问题字段。
模型页
读文字、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 键的对象。不支持额外问题字段。
模型页
读文字和 JSON,给出选项、评分或是非判断。
- 每问题每 4KB 1 积分
- 最多 32 个问题 · 每请求 64KB
- 输入:文本与 JSON
- 网关上限:纯文本模型 64KB;支持图像的模型 13MB。上方所选模型的请求限额可能更低,且包含 base64 图像。
- 单选:最多 255 个选项;Score:2–10 级
- 问题 ID:最多 128 个字符
- state 可为 null;instructions 可选且可为 null。问题 ID 不可为空。
模型页
从文本、JSON 和图片里取出类型化值的抽取模型。
- 提供方: system-one.dev
- 每 4KB 输入 2 积分
- 字段数量不影响价格。输入含 state、字段说明与图像。输出不计费。
模型页
价格以积分计。Token 用量仅供参考;实际按模型、问题数与 4KB 块计费。
模型与请求限制
在同一共享状态下最多评估 32 个问题。文本与 JSON 模型默认请求上限 64KB。支持图像的模型可在发布限额内接受内联 PNG、JPEG、WebP,网关上限 13MB。各模型能力与限额以实时目录为准。
GET /v1/models 为公开接口,返回当前已发布模型、价格与限额。推理仍需平台 API 密钥。
API 文档幂等与重试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 密钥