コンテンツへスキップ
System One

System One API。 ひとつのエンドポイント。

System One API エンドポイントで System One モデルを呼び出し、分類・スコアリング・はい/いいえ判定を実行。構造化された選択・スコア・確率を返し、実行はアプリ側で制御します。

API キーを取得Playground のサンプル

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 ドキュメント

構造化判断のための3つのプリミティブ

文脈を state として送り、評価する質問を定義。Choice・Score・Noul を1リクエストにまとめられ、各質問は同じ 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 含む）の一覧です。各ページに読み取れる入力、同時に聞ける質問数、1 回あたりのクレジットが記載されています。

Jev

1×

TypeSafe Jev structured decisions.

  • 1 クレジット / 質問 / 4KB
  • 最大 32 質問 · リクエストあたり 64KB
  • 入力：テキストと JSON
  • ゲートウェイ上限：テキスト専用 64KB、画像対応 13MB。上の選択モデルのリクエスト上限の方が低い場合があり、base64 画像も含みます。
  • 選択：最大 255 オプション；Score：2–10 レベル
  • 質問 ID：最大 128 文字
  • state は null 可。instructions は任意で null 可。質問 ID は空にできない。

モデルページ

Clef Flash

3×

Structured classification and routing for high-volume, cost-sensitive work.

  • 3 クレジット / 質問 / 4KB
  • 最大 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×

Structured decisions for demanding classification and scoring.

  • 6 クレジット / 質問 / 4KB
  • 最大 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×

Text, JSON, and image decisions for classification, routing, and scoring.

  • 4 クレジット / 質問 / 4KB
  • 最大 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×

Text and JSON decisions for classification, routing, and scoring.

  • 1 クレジット / 質問 / 4KB
  • 最大 32 質問 · リクエストあたり 64KB
  • 入力：テキストと JSON
  • ゲートウェイ上限：テキスト専用 64KB、画像対応 13MB。上の選択モデルのリクエスト上限の方が低い場合があり、base64 画像も含みます。
  • 選択：最大 255 オプション；Score：2–10 レベル
  • 質問 ID：最大 128 文字
  • state は null 可。instructions は任意で null 可。質問 ID は空にできない。

モデルページ

Clairic

2×

An extraction model that returns typed values from text, JSON and images.

  • 提供元: system-one.dev
  • 入力 4KB あたり 2 クレジット
  • フィールド数は価格に影響しません。入力には state・フィールド定義・画像が含まれます。出力は課金されません。

モデルページ

価格はクレジット建です。トークン使用量は参考表示で、課金はモデル・質問数・4KB ブロック単位です。

モデルとリクエスト制限

共有 state に対して最大 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 キーを取得