---
title: "System One API。 ひとつのエンドポイント。"
description: "System One API エンドポイントで System One モデルを呼び出し、分類・スコアリング・はい/いいえ判定を実行。構造化された選択・スコア・確率を返し、実行はアプリ側で制御します。"
canonical: "https://system-one.dev/ja/api"
language: "ja"
---

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

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

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 '{
    "state": { "message": "I was charged twice." },
    "questions": {
      "team": {
        "type": "choice",
        "instructions": "Who should handle this?",
        "criteria": {
          "billing": "Payments and refunds",
          "support": "Technical issues"
        }
      }
    }
  }'
```
## 構造化判断のための3つのプリミティブ

文脈を state として送り、評価する質問を定義。Choice・Score・Noul を1リクエストにまとめられ、各質問は同じ state に対し独立評価されます。

[Choice、Score、Noul から選ぶ](https://docs.system-one.dev/ja/docs/primitives)
## Choice：オプションを選ぶ

選択肢の集合を定義。選ばれた項目、各選択肢の確率、信頼度を受け取ります。
## Score：ルーブリックで評価

順序付きレベルを定義。レベル間にも落ちうる確率加重スコアと、分布・信頼度を受け取ります。
## Noul：はい/いいえ確率を推定

はい/いいえ質問を送る。0〜1 の P(true) を受け取り、真偽が必要なときはコード側で閾値を決めます。
## TypeScript SDK を使う

choice()・score()・booleanQuestion() で質問を定義。同じ API キーで接続し、アプリで型付き結果を受け取ります。

[SDK をホスト型 API に接続](https://docs.system-one.dev/ja/docs/getting-started)
## Clairic と意思決定モデルを比較

system-one.dev で呼べる意思決定モデル（Clairic 含む）の一覧です。各ページに読み取れる入力、同時に聞ける質問数、1 回あたりのクレジットが記載されています。

### Jev

提供元: system-one.dev

TypeSafe Jev structured decisions.

- 提供元: system-one.dev
- 1 クレジット / 質問 / 4KB
- 最大 32 質問 · リクエストあたり 64KB
- 入力：テキストと JSON
- 選択：最大 255 オプション；Score：2–10 レベル
- 公開日 2026-09-18

[モデルページ](https://system-one.dev/ja/models/jev)

### Clef Flash

提供元: system-one.dev

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

- 提供元: system-one.dev
- 3 クレジット / 質問 / 4KB
- 最大 32 質問 · リクエストあたり 13MB
- 入力：テキスト、JSON、画像（PNG、JPEG、WebP）
- 画像：最大 4 · 各 4MB · 合計 8MB
- 選択：最大 255 オプション；Score：2–10 レベル
- 公開日 2026-10-01

[モデルページ](https://system-one.dev/ja/models/clef-flash)

### Clef

提供元: system-one.dev

Structured decisions for demanding classification and scoring.

- 提供元: system-one.dev
- 6 クレジット / 質問 / 4KB
- 最大 32 質問 · リクエストあたり 13MB
- 入力：テキスト、JSON、画像（PNG、JPEG、WebP）
- 画像：最大 4 · 各 4MB · 合計 8MB
- 選択：最大 255 オプション；Score：2–10 レベル
- 公開日 2026-10-01

[モデルページ](https://system-one.dev/ja/models/clef)

### Clef Omni

提供元: system-one.dev

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

- 提供元: system-one.dev
- 4 クレジット / 質問 / 4KB
- 最大 32 質問 · リクエストあたり 13MB
- 入力：テキスト、JSON、画像（PNG、JPEG、WebP）
- 画像：最大 4 · 各 4MB · 合計 8MB
- 選択：最大 255 オプション；Score：2–10 レベル
- 公開日 2026-10-09

[モデルページ](https://system-one.dev/ja/models/clef-omni)

### Decider

提供元: system-one.dev

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

- 提供元: system-one.dev
- 1 クレジット / 質問 / 4KB
- 最大 32 質問 · リクエストあたり 64KB
- 入力：テキストと JSON
- 選択：最大 255 オプション；Score：2–10 レベル
- 公開日 2026-10-07

[モデルページ](https://system-one.dev/ja/models/decider-v1-1)

### Clairic

提供元: system-one.dev

Extract typed values with confidence and p_null from text and images.

- 提供元: system-one.dev
- 入力 4KB あたり 2 クレジット
- 入力：テキスト、JSON、画像（PNG、JPEG、WebP）
- 画像：最大 4 · 各 4MB · 合計 8MB
- 公開日 2026-10-19

[モデルページ](https://system-one.dev/ja/models/clairic)

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


## System One の呼び出しを始める

### キーを作成

コンソールで API キーを作成し、サーバー環境に保存します。完全なキーは一度だけ表示されます。

### リクエストを送る

cURL 例をコピーするか、HTTP クライアントを使います。SDK のインストールは不要です。

### 利用状況を確認

コンソールでリクエスト状態、クレジット課金、残高を確認します。

## Authentication

Sign in or create an account, complete any required email verification, then open API keys and create a named key. The complete key is displayed once. Copy it into your server environment or secret manager. The website Playground uses the signed-in session; external applications use the platform key.

[Authentication](https://system-one.dev/ja/auth.md)
## Failure and retry accounting

Credits are reserved before inference and returned on a recorded failed inference. A successful replay using the same Idempotency-Key and body incurs no new inference or debit while its replay record remains available. Different input with the same key is rejected. After a timeout or uncertain result, check recorded usage before retrying and preserve the key. Reconciliation can be pending; do not assume a refund until the recorded outcome confirms it.

## Start here

- [Developer documentation](https://docs.system-one.dev/ja)
- [Versioning and deprecation](https://docs.system-one.dev/ja/docs/api/versioning)
- [冪等性とリトライ](https://docs.system-one.dev/ja/docs/api/idempotency)
- [API エラー](https://docs.system-one.dev/ja/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/ja/sdk)
- [API reference](https://system-one.dev/ja/api)
- [Models](https://system-one.dev/ja/models)
- [モデルカタログ](https://docs.system-one.dev/ja/docs/models)
- [Authentication](https://system-one.dev/ja/auth.md)
- [Pricing](https://system-one.dev/ja/pricing)
- [クレジット課金](https://docs.system-one.dev/ja/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/ja/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/ja/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/ja/about)
- [Contact](https://system-one.dev/ja/contact)
- [Playground samples](https://system-one.dev/ja/demo)
- [ブログ](https://system-one.dev/ja/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)