본문으로 건너뛰기
PleumRouter
시작하기

Models

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

GET/v1/models

쿼리 파라미터#

파라미터타입필수설명
providerstring선택프로바이더 ID 필터 (예: modelark, anthropic, upstage). modelark가 정식 ID이며 byteplus는 입력만 허용하는 legacy alias입니다. 응답은 항상 modelark를 반환합니다.
localeko | 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-260428",
      "provider": "modelark",
      "display_name": "ByteDance Seed 2.0 Lite (260428)",
      "description": "ByteDance Seed 2.0 Lite (260428) applies ByteDance's Seed 2 family to general dialogue, document understanding, and text generation. The public catalog limits for the Lite release are 256,000 context tokens and 128,000 output tokens.",
      "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", "reasoning_effort"
      ],
      "supports_thinking": true,
      "thinking_forced": false,
      "pricing": {"prompt": "0.00000025", "completion": "0.000002"},
      "pricing_krw": {"prompt": "0.000336423750", "completion": "0.0026913900"},
      "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.00000025", "completion": "0.000002"},
          "pricing_krw": {"prompt": "0.000336423750", "completion": "0.0026913900"},
          "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": []
        }
      ]
    }
  ]
}

필드 설명#

파라미터타입필수설명
modalitystring선택text | image | video | audio | embedding | 3d | systemone.
makerstring선택모델 제조사(랩). 호스팅 프로바이더(provider)와 구분됩니다 — 예: maker=DeepSeek, provider=deepinfra.
price_unitstring선택과금 단위. 텍스트 모델은 token.
markup_tierstring선택low | medium | high. 마크업 등급이며, 현재 모든 등급의 마크업이 0%입니다.
effective_markup_percentnumber선택표시·청구에 실제 적용되는 마크업(%). 모델별 override가 있으면 그 값, 없으면 전역 기본값.
context_windowinteger선택최대 컨텍스트 토큰 수.
max_outputinteger선택최대 출력 토큰 수.
context_length / max_output_tokensinteger선택context_window · max_output의 OpenRouter 표준 별칭(같은 값).
architectureobject선택{input_modalities, output_modalities} — modality에서 파생.
input_modalities / output_modalitiesstring[]선택입력·출력 모달리티 배열. 이미지 입력은 input_modalities에 image가 있는 모델에서만 쓸 수 있습니다.
operationsstring[]선택이 모델로 실행할 수 있는 operation ID(예: chat.generate, image.generate, embedding.create).
recommendedboolean선택추천 모델이면 true.
promo_discount_factor / promo_ends_atnumber | null / string | null선택기간 한정 프로모션이 진행 중일 때만 값이 있는 할인 계수(예: 0.5)와 종료 시각. 진행 중이 아니면 null.
supported_parametersstring[]선택모델이 받는 OpenAI 표준 파라미터 목록. 텍스트 모델은 공통 목록, 비텍스트 모달리티는 빈 배열.
supports_thinkingboolean선택추론(reasoning_effort) 토글 지원 여부.
thinking_forcedboolean선택추론이 강제(끌 수 없음)인 모델이면 true.
pricingobject선택{prompt, completion} — 토큰당 실효 USD 단가(정가 × 마크업)의 고정소수 문자열. token 과금 모델만 채워지고 그 외 모달리티는 빈 객체.
pricing_krwobject선택{prompt, completion} — 토큰당 KRW. 09:00 스냅샷의 적용 환율(환율 마크업 포함) 기준이라 실제 청구 환율(10분 갱신)과 장중 미세 차이가 있을 수 있으며, 환율 미가용 시 생략됩니다.
pricing_tiersarray선택대표 offering의 token 가격 구간. 각 항목은 input_tokens_lte와 input/output/cache USD/1M을 가집니다. tier 정책이 아니면 빈 배열입니다.
pricing_variantsarray선택대표 offering의 이미지·영상·임베딩·3d 등 variant 가격 구간. variant 정책이 아니면 빈 배열입니다.
providersarray선택이 논리 모델을 서빙하는 프로바이더별 단가 비교. 단일 프로바이더 모델은 길이 1.
providers[].pricing_policyobject | null선택해당 provider offering의 versioned 공식 가격 정책(version, kind, tiers/variants, 그리고 mixed embedding이면 content-type별 input USD/1M). flat 가격보다 정확한 정산 기준입니다.
providers[].pricing_tiersarray선택providers[].pricing_policy.tiers의 편의 뷰. token tier가 아니면 빈 배열입니다.
providers[].pricing_variantsarray선택providers[].pricing_policy.variants의 편의 뷰. modality variant가 아니면 빈 배열입니다.
descriptionstring선택요청 locale로 선택한 모델 설명.
billing_modeunit_price | routed_payg선택일반 고정 단가 모델과 자식 실사용량 과금 라우팅 부모를 구분하는 명시적 계약.
cost_basisstring | 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

Auto 라우팅의 출시 상태와 호출 방식을 조회합니다. 항목의 availability와 invocable로 지금 호출할 수 있는지 확인하세요.

쿼리 파라미터#

파라미터타입필수설명
localeko | en | es | zh | ja선택description과 cost_basis 언어. 기본값 en. 목록·상세·라우팅 모드 모두 지원합니다.

필드 설명#

파라미터타입필수설명
billing_moderouted_payg선택모든 모드는 실행된 하위 호출의 실제 사용량으로 과금됩니다.
cost_basisstring선택요청 locale로 설명한 과금 합산 기준.
availabilityavailable | beta | setup_required | disabled선택현재 출시·설정 상태. disabled는 호출 가능으로 해석하면 안 됩니다.
invocableboolean선택literal 모델 ID로 현재 호출 가능한지 여부.
invocationobject선택model_id를 담은 실제 진입 방식.
docs_pathstring선택해당 모드의 제품 문서 경로.
200 OK
{
  "object": "list",
  "data": [
    {
      "id": "auto",
      "display_name": "Auto",
      "description": "Sorts each request into a kind of work and picks the best model for it.",
      "billing_mode": "routed_payg",
      "cost_basis": "Only the input and output tokens of the model actually selected — no routing fee",
      "availability": "available",
      "invocable": true,
      "invocation": {"type": "model", "model_id": "auto"},
      "docs_path": "/docs/features/auto"
    }
  ]
}
다음Embeddings