GET /v1/models | everyais

사용 가능한 모델 목록을 반환합니다. API 키에 허용 모델이 설정돼 있으면 그 목록으로 필터됩니다. 응답에는 Cache-Control: private, max-age=60 이 붙습니다.

Response

{
  "object": "list",
  "data": [
    {
      "id": "everyais/claude-opus-5",
      "aliases": ["claude-opus-5"],
      "object": "model",
      "owned_by": "everyais",
      "created": 1782008704,
      "registered_at": "2026-06-21",
      "released_at": "2026-06-21",
      "name": "Claude Opus 5",
      "description": "Anthropic Claude 의 Opus 등급 모델이다. 같은 세대에서 가장 높은 성능을 목표로 하는 최상위 등급으로 복잡한 추론과 장문 작업에 배치한다. 텍스트·이미지 입력과 도구 호출을 지원한다.",
      "series": "claude",
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "knowledge_cutoff": null,
      "price_search_per_query": null,
      "supply": "first_party",
      "category": "LLM",
      "type": "chat",
      "supported_endpoints": ["/v1/chat/completions"],
      "capabilities": {
        "streaming": true,
        "tool_use": true,
        "vision": true,
        "json_mode": true,
        "reasoning": false,
        "web_search": false
      },
      "limits": { "max_tokens": 8192, "context_window": 200000 },
      "pricing": {
        "unit": "per_1m_tokens",
        "input_per_1m": 3.51,
        "output_per_1m": 17.55
      },
      "available": true
    }
  ]
}

created 는 OpenAI 호환용 epoch 값이고, registered_at(게이트웨이 등록일)과 released_at(모델 출시일)은 별개 필드입니다.

supply 는 이 모델이 어디서 서빙되는지입니다 — first_party 는 everyais 가 직접 계약한 클라우드, community 는 제3자 공급자의 GPU(우리가 운영하지 않는 하드웨어에서 프롬프트가 처리됩니다), mixed 는 둘 다 가능한 모델입니다. 커뮤니티 공급은 계정 기본값이 꺼짐이며 대시보드 설정에서 켜야 씁니다. 꺼져 있으면 커뮤니티 전용 모델은 목록에 나오지 않고, 호출하면 403 community_supply_not_allowed 입니다.

pricing.unit 은 per_1m_tokens · per_image · per_second 중 하나이며, 비디오 모델은 pricing.variants[] 에 {key, price} 변형 단가가 함께 옵니다. 가격 숫자는 everyais가 승인한 모델 기준 원가입니다. 실제 청구액은 요청 시점에 계정 요율을 별도로 적용해 계산합니다.

표시 메타 필드

필드	설명
`name`	사람이 읽는 표시명
`description`	모델 설명. 현재 한국어로만 제공됩니다. 없으면 null
`series`	모델 계열 토큰(`claude` · `gemini` · `gpt` 등). 없으면 null
`input_modalities`	입력 모달리티 — `text` · `image`
`output_modalities`	출력 모달리티 — `text` · `image` · `video`
`knowledge_cutoff`	학습 지식 컷오프 `YYYY-MM-DD`. 공급사 공식 발표가 있는 모델만 채우고 나머지는 null 입니다(추정값을 넣지 않습니다)
`price_search_per_query`	웹 검색 쿼리당 기준 원가(USD). 미지원이거나 공개 기준 원가가 없으면 null이며 0이 아닙니다
`available`	지금 호출 가능한지 여부
`aliases`	이 모델로 해석되는 공개 이름 (마지막 세그먼트·점 표기·Cursor/OpenAI 관용 ID). 목록에 별도 행으로 복제하지 않습니다

capabilities.vision 은 input_modalities 에 image 가 있으면 true 입니다. 웹 검색 지원 여부는 capabilities.web_search 로 판정하세요. price_search_per_query 는 공개 가능한 기준 원가가 있을 때만 숫자이며, null 이어도 capability가 true일 수 있습니다. 위 예시의 Claude 는 이미지 입력을 받으므로 vision 이 true이고 웹 검색은 지원하지 않습니다.

모델의 공급 경로별 성능·uptime 과 일별 사용량 시계열은 무인증 공개 API GET /models/stats 에서 조회합니다.

GET /v1/models/{model}

개별 모델을 조회합니다. 모델 id 는 슬래시를 포함하므로 경로에 그대로 이어 붙입니다.

GET /v1/models/everyais/gemini-3-5-flash

존재하지 않거나 접근 권한이 없으면 404 model_not_found 를 반환합니다.