---
title: "System One API. 하나의 엔드포인트."
description: "System One API 엔드포인트로 System One 모델을 호출해 분류·점수·예/아니오 검사를 수행하세요. 구조화된 선택·점수·확률을 받고, 실행은 애플리케이션이 제어합니다."
canonical: "https://system-one.dev/ko/api"
language: "ko"
---

# 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"
        }
      }
    }
  }'
```
## 구조화 결정을 위한 세 가지 프리미티브

컨텍스트를 state로 보내고 평가할 질문을 정의하세요. 한 요청에 Choice·Score·Noul을 조합할 수 있으며, 각 질문은 같은 state에 대해 독립적으로 평가됩니다.

[Choice, Score, Noul 중 선택](https://docs.system-one.dev/ko/docs/primitives)
## Choice: 옵션 선택

선택지 집합을 정의하세요. 선택된 항목, 각 선택지 확률, 신뢰도를 받습니다.
## Score: 루브릭으로 평가

순서 있는 수준을 기술하세요. 수준 사이에 떨어질 수 있는 확률 가중 점수와 분포·신뢰도를 받습니다.
## Noul: 예/아니오 확률 추정

예/아니오 질문을 하세요. 0~1의 P(true)를 받고, 불리언이 필요하면 코드에서 임계값을 정합니다.
## TypeScript SDK 사용

choice(), score(), booleanQuestion()으로 질문을 정의하세요. 같은 API 키로 연결해 애플리케이션에서 타입 있는 결과를 받습니다.

[SDK를 호스팅 API에 연결](https://docs.system-one.dev/ko/docs/getting-started)
## Clairic과 의사결정 모델 비교

system-one.dev에서 호출할 수 있는 모든 의사결정 모델(Clairic 포함) 목록입니다. 각 페이지에 읽을 수 있는 입력, 한 번에 물을 수 있는 질문 수, 호출당 크레딧이 안내됩니다.

### Jev

제공: system-one.dev

TypeSafe Jev structured decisions.

- 제공: system-one.dev
- 질문당 4KB마다 1 크레딧
- 최대 32개 질문 · 요청당 64KB
- 입력: 텍스트와 JSON
- 선택: 최대 255개 옵션; Score: 2–10단계
- 출시 2026-09-18

[모델 페이지](https://system-one.dev/ko/models/jev)

### Clef Flash

제공: system-one.dev

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

- 제공: system-one.dev
- 질문당 4KB마다 3 크레딧
- 최대 32개 질문 · 요청당 13MB
- 입력: 텍스트, JSON, 이미지(PNG, JPEG, WebP)
- 이미지: 최대 4 · 각 4MB · 합계 8MB
- 선택: 최대 255개 옵션; Score: 2–10단계
- 출시 2026-10-01

[모델 페이지](https://system-one.dev/ko/models/clef-flash)

### Clef

제공: system-one.dev

Structured decisions for demanding classification and scoring.

- 제공: system-one.dev
- 질문당 4KB마다 6 크레딧
- 최대 32개 질문 · 요청당 13MB
- 입력: 텍스트, JSON, 이미지(PNG, JPEG, WebP)
- 이미지: 최대 4 · 각 4MB · 합계 8MB
- 선택: 최대 255개 옵션; Score: 2–10단계
- 출시 2026-10-01

[모델 페이지](https://system-one.dev/ko/models/clef)

### Clef Omni

제공: system-one.dev

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

- 제공: system-one.dev
- 질문당 4KB마다 4 크레딧
- 최대 32개 질문 · 요청당 13MB
- 입력: 텍스트, JSON, 이미지(PNG, JPEG, WebP)
- 이미지: 최대 4 · 각 4MB · 합계 8MB
- 선택: 최대 255개 옵션; Score: 2–10단계
- 출시 2026-10-09

[모델 페이지](https://system-one.dev/ko/models/clef-omni)

### Decider

제공: system-one.dev

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

- 제공: system-one.dev
- 질문당 4KB마다 1 크레딧
- 최대 32개 질문 · 요청당 64KB
- 입력: 텍스트와 JSON
- 선택: 최대 255개 옵션; Score: 2–10단계
- 출시 2026-10-07

[모델 페이지](https://system-one.dev/ko/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/ko/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/ko/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/ko)
- [Versioning and deprecation](https://docs.system-one.dev/ko/docs/api/versioning)
- [멱등성과 재시도](https://docs.system-one.dev/ko/docs/api/idempotency)
- [API 오류](https://docs.system-one.dev/ko/docs/api/errors)
- [TypeScript SDK](https://system-one.dev/ko/sdk)
- [API reference](https://system-one.dev/ko/api)
- [Models](https://system-one.dev/ko/models)
- [모델 카탈로그](https://docs.system-one.dev/ko/docs/models)
- [Authentication](https://system-one.dev/ko/auth.md)
- [Pricing](https://system-one.dev/ko/pricing)
- [크레딧 과금](https://docs.system-one.dev/ko/docs/billing)
- [OpenAPI specification](https://system-one.dev/openapi.json)
- [Agent integration guide](https://system-one.dev/ko/skill.md)
- [System One for Coding Agents: Cursor, Claude Code, Codex](https://docs.system-one.dev/ko/docs/coding-agents)
- [Installable coding-agent skill](https://system-one.dev/skills/system-one/SKILL.md)
- [About](https://system-one.dev/ko/about)
- [Contact](https://system-one.dev/ko/contact)
- [Playground samples](https://system-one.dev/ko/demo)
- [블로그](https://system-one.dev/ko/blog)
- [SDK source](https://github.com/ziyu/system-one-sdk)
- [@system-one-ai/core (npm)](https://www.npmjs.com/package/@system-one-ai/core)