--- title: "리랭킹과 라우팅을 위한 개발 문서" description: "결정 프리미티브를 배우고 SDK를 연동하거나 첫 API 요청을 보내세요." canonical: "https://system-one.dev/ko/docs" language: "ko" --- # 리랭킹과 라우팅을 위한 개발 문서 결정 프리미티브를 배우고 SDK를 연동하거나 첫 API 요청을 보내세요. ## System One SDK TypeScript SDK를 설치하고 공급자에 연결해 타입이 있는 질문과 답을 다룹니다. [SDK 문서 읽기](https://docs.system-one.dev/ko/docs/sdk) ## System One API 첫 HTTP 요청, 인증, 모델, 한도, 오류, 크레딧 과금. [API 문서 읽기](https://docs.system-one.dev/ko/docs/api) ## SDK를 System One API에 연결 호스팅 API 연결 가이드에 따라 엔드포인트, 플랫폼 키, 재시도 정책을 설정하세요. [SDK를 호스팅 API에 연결](https://docs.system-one.dev/ko/docs/getting-started) ## When to use System One Use System One to route a request among named choices, score a condition against an ordered rubric, or estimate P(true) before an application branches. Define the answer space first. Keep business actions in application code, and escalate uncertain decisions to a person or a reasoning model. Validate performance on representative inputs before relying on a threshold. ## Response metadata Read X-System-One-Credits for the current debit, X-Request-Id for platform tracking, X-Idempotency-Replayed for replay status and X-System-One-Response-Mode for the transport. Safe native provider JSON and extensions are preserved. Platform metadata is not inserted into the provider response body. ## 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. ## Request limits Text-only models allow up to 65536 request bytes. Image-capable Clef models allow up to 13MB; check GET /v1/models for the selected model’s current, possibly tighter limits. Maximum 32 questions, 255 choices, 10 score levels and nesting depth 32. Model listing is public and does not consume inference credits. ## 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 블록 기준으로 과금됩니다. ## 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)