Models

사용 가능한 모델 목록과 가격을 조회합니다. 인증 없이 호출할 수 있습니다.

GET/v1/models

쿼리 파라미터#

파라미터	타입	필수	설명
provider	string	선택	프로바이더 ID 필터 (예: modelark, anthropic, upstage). modelark가 정식 ID이며 byteplus는 입력만 허용하는 legacy alias입니다. 응답은 항상 modelark를 반환합니다.
locale	ko \| en \| es \| zh \| ja	선택	description과 cost_basis 언어. 기본값 en. 목록·상세·라우팅 모드 모두 지원합니다.

응답#

input_price_usd · output_price_usd는 1M 토큰당 USD 정가(프로바이더 공시가, 마크업 미포함)이고, pricing · pricing_krw는 토큰당 실효 단가(정가 × 마크업, 실제 청구와 동일한 마크업)입니다. 원화 환산 가격은 모델 페이지에서도 오늘 환율 기준으로 확인할 수 있습니다. 정확한 구간·모달리티별 공시가는pricing_tiers · pricing_variants 및 각 offering의pricing_policy를 사용합니다.

라우팅 부모의 input_price_usd · output_price_usd = 0은 기존 클라이언트 호환용 값이며 무료를 뜻하지 않습니다. 반드시 billing_mode=routed_payg와 cost_basis를 사용해 표시하세요.

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "seed-2-0-lite-260228",
      "provider": "modelark",
      "display_name": "ByteDance Seed 2.0 Lite",
      "description": "A multimodal model in the Seed family for text and vision workloads.",
      "billing_mode": "unit_price",
      "cost_basis": null,
      "modality": "text",
      "maker": "ByteDance",
      "price_unit": "token",
      "input_price_usd": 0.25,
      "output_price_usd": 2.0,
      "markup_tier": "medium",
      "effective_markup_percent": 0.0,
      "context_window": 256000,
      "max_output": 128000,
      "is_active": true,
      "context_length": 256000,
      "max_output_tokens": 128000,
      "architecture": {
        "input_modalities": ["text"],
        "output_modalities": ["text"]
      },
      "supported_parameters": [
        "temperature", "max_tokens", "top_p", "stop", "seed",
        "frequency_penalty", "presence_penalty", "tools", "tool_choice",
        "response_format", "parallel_tool_calls", "logit_bias", "stream"
      ],
      "supports_thinking": true,
      "thinking_forced": false,
      "pricing": {"prompt": "0.0000002625", "completion": "0.0000021"},
      "pricing_krw": {"prompt": "0.0003675", "completion": "0.00294"},
      "pricing_tiers": [
        {
          "input_tokens_lte": 128000,
          "input_price_usd_per_m": 0.25,
          "output_price_usd_per_m": 2.0,
          "cache_read_price_usd_per_m": 0.05
        },
        {
          "input_tokens_lte": 256000,
          "input_price_usd_per_m": 0.5,
          "output_price_usd_per_m": 4.0,
          "cache_read_price_usd_per_m": 0.1
        }
      ],
      "pricing_variants": [],
      "providers": [
        {
          "provider": "modelark",
          "input_price_usd": 0.25,
          "output_price_usd": 2.0,
          "markup_tier": "medium",
          "effective_markup_percent": 0.0,
          "context_window": 256000,
          "cache_read_usd": 0.05,
          "latency_ms": null,
          "throughput_tps": null,
          "pricing": {"prompt": "0.0000002625", "completion": "0.0000021"},
          "pricing_krw": {"prompt": "0.0003675", "completion": "0.00294"},
          "pricing_policy": {
            "version": 1,
            "kind": "token_tiers",
            "tiers": [
              {
                "input_tokens_lte": 128000,
                "input_price_usd_per_m": 0.25,
                "output_price_usd_per_m": 2.0,
                "cache_read_price_usd_per_m": 0.05
              },
              {
                "input_tokens_lte": 256000,
                "input_price_usd_per_m": 0.5,
                "output_price_usd_per_m": 4.0,
                "cache_read_price_usd_per_m": 0.1
              }
            ]
          },
          "pricing_tiers": [
            {
              "input_tokens_lte": 128000,
              "input_price_usd_per_m": 0.25,
              "output_price_usd_per_m": 2.0,
              "cache_read_price_usd_per_m": 0.05
            },
            {
              "input_tokens_lte": 256000,
              "input_price_usd_per_m": 0.5,
              "output_price_usd_per_m": 4.0,
              "cache_read_price_usd_per_m": 0.1
            }
          ],
          "pricing_variants": []
        }
      ]
    }
  ]
}

필드 설명#

파라미터	타입	필수	설명
modality	string	선택	text \| image \| video \| audio \| embedding \| 3d.
maker	string	선택	모델 제조사(랩). 호스팅 프로바이더(provider)와 구분됩니다 — 예: maker=DeepSeek, provider=deepinfra.
price_unit	string	선택	과금 단위. 텍스트 모델은 token.
markup_tier	string	선택	low \| medium \| high. 현재 모든 티어에 단일 수수료가 적용됩니다.
effective_markup_percent	number	선택	표시·청구에 실제 적용되는 마크업(%). 모델별 override가 있으면 그 값, 없으면 전역 기본값.
context_window	integer	선택	최대 컨텍스트 토큰 수.
max_output	integer	선택	최대 출력 토큰 수.
context_length / max_output_tokens	integer	선택	context_window · max_output의 OpenRouter 표준 별칭(같은 값).
architecture	object	선택	{input_modalities, output_modalities} — modality에서 파생.
supported_parameters	string[]	선택	모델이 받는 OpenAI 표준 파라미터 목록. 텍스트 모델은 공통 목록, 비텍스트 모달리티는 빈 배열.
supports_thinking	boolean	선택	추론(reasoning_effort) 토글 지원 여부.
thinking_forced	boolean	선택	추론이 강제(끌 수 없음)인 모델이면 true.
pricing	object	선택	{prompt, completion} — 토큰당 실효 USD 단가(정가 × 마크업)의 고정소수 문자열. token 과금 모델만 채워지고 그 외 모달리티는 빈 객체.
pricing_krw	object	선택	{prompt, completion} — 토큰당 KRW. 표시환율(09:00 스냅샷) 기준이라 실제 청구 환율(10분 갱신)과 장중 미세 차이가 있을 수 있으며, 환율 미가용 시 생략됩니다.
pricing_tiers	array	선택	대표 offering의 token 가격 구간. 각 항목은 input_tokens_lte와 input/output/cache USD/1M을 가집니다. tier 정책이 아니면 빈 배열입니다.
pricing_variants	array	선택	대표 offering의 이미지·영상·임베딩·3d 등 variant 가격 구간. variant 정책이 아니면 빈 배열입니다.
providers	array	선택	이 논리 모델을 서빙하는 프로바이더별 단가 비교. 단일 프로바이더 모델은 길이 1.
providers[].pricing_policy	object \| null	선택	해당 provider offering의 versioned 공식 가격 정책(version, kind, tiers/variants, 그리고 mixed embedding이면 content-type별 input USD/1M). flat 가격보다 정확한 정산 기준입니다.
providers[].pricing_tiers	array	선택	providers[].pricing_policy.tiers의 편의 뷰. token tier가 아니면 빈 배열입니다.
providers[].pricing_variants	array	선택	providers[].pricing_policy.variants의 편의 뷰. modality variant가 아니면 빈 배열입니다.
description	string	선택	요청 locale로 선택한 모델 설명.
billing_mode	unit_price \| routed_payg	선택	일반 고정 단가 모델과 자식 실사용량 과금 라우팅 부모를 구분하는 명시적 계약.
cost_basis	string \| null	선택	routed_payg에서 합산되는 실제 하위 호출. unit_price에서는 null.

providers[]의 각 항목은 프로바이더별 offering(단가 · 마크업 · 컨텍스트 · 캐시 읽기 정가 cache_read_usd(USD/1M, tier 모델은 기본 구간 요약이며 정확한 값은 pricing_tiers에 있음))입니다. 최상위 provider · 단가 · pricing은 최저가 offering의 대표값입니다. 최상위 pricing_tiers · pricing_variants도 이 대표 offering의 branch만 보여 주며, provider 간 가격을 합치지 않습니다. 정확한 provider별 정책은 providers[].pricing_policy 및 그 convenience view인providers[].pricing_tiers · providers[].pricing_variants에서 확인합니다.latency_ms · throughput_tps는 목록 응답에서는 null이고, 단일 모델 상세 (GET /v1/models/{model_id})에서만 우리 트래픽 실측값으로 채워집니다.

단일 모델 상세 GET /v1/models/{model_id}?locale=ko에는 목록 필드에 더해 official_sources[](publisher, title, url, scope, verified_at)가 포함됩니다. 출처를 추측할 수 없는 커스텀 모델은 빈 배열입니다.

라우팅 모드#

GET/v1/routing-modes

네 라우팅 상품의 출시 상태와 호출 방식을 조회합니다. 모델형 모드는 게이트와 활성·공개 DB 모델 행이 모두 있어야 호출 가능하며, Selected Smart는 policy/<slug> 설정이 필요합니다.

파라미터	타입	필수	설명
locale	ko \| en \| es \| zh \| ja	선택	description과 cost_basis 언어. 기본값 en. 목록·상세·라우팅 모드 모두 지원합니다.
billing_mode	routed_payg	선택	네 모드 모두 실행된 하위 호출의 실제 사용량으로 과금됩니다.
cost_basis	string	선택	요청 locale로 설명한 과금 합산 기준.
availability	available \| beta \| setup_required \| disabled	선택	현재 출시·설정 상태. disabled는 호출 가능으로 해석하면 안 됩니다.
invocable	boolean	선택	literal 모델 ID로 현재 호출 가능한지 여부.
invocation	object	선택	model_id 또는 policy_type=auto를 담은 실제 진입 방식.
docs_path	string	선택	해당 모드의 제품 문서 경로.

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "benchmark_smart",
      "display_name": "Benchmark Smart",
      "description": "Classifies each request and selects a suitable model using PleumRouter's benchmark table.",
      "billing_mode": "routed_payg",
      "cost_basis": "Actual input and output usage of the selected child model",
      "availability": "available",
      "invocable": true,
      "invocation": {"type": "model", "model_id": "benchmark_smart"},
      "docs_path": "/docs/features/benchmark-smart"
    },
    {
      "id": "selected_smart",
      "display_name": "Selected Smart",
      "description": "Routes within a model pool configured by the user.",
      "billing_mode": "routed_payg",
      "cost_basis": "Actual usage of the child model selected by the policy",
      "availability": "setup_required",
      "invocable": false,
      "invocation": {"type": "policy", "policy_type": "auto"},
      "docs_path": "/docs/features/selected-smart"
    }
  ]
}