NNexithDocs
상태대시보드 ↗
개요 및 빠른 시작모델 카탈로그가이드API 레퍼런스연동OAuth2 / OIDC

Models

GET /v1/models · 현재 호출 가능한 모델 나열

호출 가능한 모델만 반환합니다: is_active=true이고 status=available. 내부 모델 (standby/router/cache-embed 등)과 지원 종료된 모델은 나타나지 않습니다.


요청#

GET /v1/models
Authorization: Bearer nx-...

응답#

{
  "object": "list",
  "data": [
    {
      "id": "nexith-core",
      "object": "model",
      "created": 1787585154,
      "owned_by": "nexith",
      "display_name": "Nexith Core",
      "description": "Nexith default general-purpose model for chat, writing, summarization, and everyday code.",
      "model_code": "NX-C1",
      "category": "text",
      "status": "available",
      "context_length": 1048576,
      "max_output": 131072,
      "input_price": "8",
      "output_price": "30",
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"]
    },
    {
      "id": "nexith-image",
      "object": "model",
      "created": 1787585154,
      "owned_by": "nexith",
      "display_name": "Nexith Image",
      "description": "Image generation and editing model.",
      "model_code": "NX-I1",
      "category": "image",
      "status": "available",
      "context_length": 0,
      "max_output": 0,
      "input_price": "0",
      "output_price": "0",
      "input_modalities": ["text", "image"],
      "output_modalities": ["image"]
    }
  ]
}

필드#

필드 설명
id 모델 ID(요청의 model에 사용)
display_name 표시 이름
description 소개
model_code 내부 코드(NX-C1 / NX-I1)
category text / image
status available 등; available만 이 API에 나타납니다
context_length 컨텍스트 창(tokens)
max_output 최대 출력(tokens)
input_price / output_price 텍스트 모델은 1M tokens당 달러 가격, 이미지 모델은 0(장당 과금)
input_modalities / output_modalities 지원하는 모달리티

이미지 모델은 장당 과금이므로 가격이 위 표에서 input_price/output_price = 0으로 표시되며, 실제 단가는 가격을 참고하세요.


설명#

  • 별칭(예: nexith-8b)은 독립 항목으로 나타나지 않지만 model 필드에 직접 사용할 수 있습니다.
  • 이 API는 읽기 전용 파사드입니다: 데이터베이스가 잠시 사용 불가하면 게이트웨이가 메모리 스냅숏으로 폴백해 핵심 필드를 계속 반환합니다.
  • 모델 추가/지원 종료 시 이 API를 먼저 업데이트하고 지원 종료 기록에 기록합니다.