본문으로 건너뛰기
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 문서

구조화 결정을 위한 세 가지 프리미티브

컨텍스트를 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 structured decisions.

  • 질문당 4KB마다 1 크레딧
  • 최대 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.

  • 질문당 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×

Structured decisions for demanding classification and scoring.

  • 질문당 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×

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

  • 질문당 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×

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

  • 질문당 4KB마다 1 크레딧
  • 최대 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 키 받기