GET /v1/models | everyais

모델 목록을 반환합니다. 키의 허용 모델 목록과 계정·조직의 커뮤니티 공급/학습 사용 정책으로 필터됩니다. 응답에는 Cache-Control: private, max-age=60 이 붙습니다.

capabilities의 불리언은 true=지원, false=미지원이고 필드 생략은 지원 미확인입니다. sampling, json_mode, json_mode_with_tools, web_search_with_tools, structured_outputs, parallel_tool_calls, image_mask를 구분하세요. limits.reasoning_efforts, limits.supported_sizes, limits.supported_qualities, limits.supported_durations, limits.max_images는 모델별 지원값입니다. 빈 목록은 지원값이 없음을 뜻합니다. 같은 공개 모델 ID에 여러 공급 경로가 있으면 공통으로 보장할 수 있는 값만 공개합니다. 옵션 간 조합과 생성/편집 차이는 각 엔드포인트 문서를 함께 확인하세요.

공급 경로별 파라미터

GET /v1/models의 parameter_constraints는 [{ provider, parameters }] 배열입니다. provider는 정규화한 공급사 slug이고, parameters는 chat, image-generation, image-edit, video별 API 파라미터를 담습니다. 각 값은 supported, type, allowed_values, minimum, maximum으로 지원 여부·허용값·범위를 설명합니다. 예: {"provider":"google-vertex","parameters":{"chat":{"temperature":{"supported":true,"type":"number","minimum":0,"maximum":2}}}}.

response_format.type·extra_body.google.top_k처럼 중첩 필드는 점으로 구분합니다. 필드 생략은 지원 미확인이며 제한 없음이 아닙니다. 생성과 편집의 제약은 다를 수 있습니다. 여러 경로의 허용값을 합치지 말고 공통 교집합을 사용하세요. 기존 capabilities·limits는 공통 보장값을 유지합니다. 이전 API 응답에는 parameter_constraints 자체가 없을 수 있습니다.

문서의 모델별 최신 옵션과 Playground는 같은 라이브 모델 메타데이터를 사용합니다. 지원 미확인 모델도 목록에 남습니다. 명시한 미지원 파라미터·허용값 위반은 크레딧 예약 전 검증하여 400, error.code: "unsupported_parameter"와 문제 필드의 error.param을 반환합니다. 저장한 옵션은 모델을 바꿀 때 다시 확인하세요.

반환값

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

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

pricing.unit 은 per_1m_tokens · per_image · per_second 중 하나이며, 비디오 모델은 pricing.variants[] 에 {key, price} 변형 단가가 함께 옵니다.

pricing.is_free === true 는 사용자 입력·출력·캐시 토큰 요금이 무료임을 뜻합니다. 웹 검색 비용은 포함하지 않으며 별도로 과금됩니다. 가격이 0이라는 이유로 무료로 추론하지 마세요. 플래그가 없거나 false이면 무료 표시를 하지 않습니다. 공개 토큰 가격은 현재 제공 가능한 엔드포인트 중 입력·출력 단가의 합이 가장 낮은 한 곳의 가격 묶음입니다. 표준·장문 구간은 별도로 선택하며 캐시 단가는 해당 구간과 같은 엔드포인트를 따릅니다. 입력 최저가와 출력 최저가를 서로 다른 경로에서 조합하지 않습니다. 미디어 가격은 같은 과금 단위끼리, 변형 단가는 같은 key·meta끼리 최저가를 비교합니다. 모든 표시 가격은 마크업 없이 표시 할인을 반영합니다. 실제 청구액은 요청 시점에 계정 요율을 별도로 적용해 계산합니다. 수동으로 고정한 모델 기준가는 청구 기준이며 공개 최저가를 고정하지 않습니다.

pricing.conditions는 표시 최저가에 필요한 동의 목록입니다. community_supply는 커뮤니티 공급 허용, training_use는 공급사가 프롬프트·응답을 학습에 사용하는 경로 허용이 필요하다는 뜻입니다. 선택된 표준·장문 구간, 미디어·변형 단가에 필요한 조건을 함께 표시하며, 조건이 없으면 이 필드를 생략합니다. 모델 전체의 supply·training_use 분류만으로 가격 조건을 추론하지 마세요. 공개 카탈로그는 이 조건을 안내하고, 인증된 키의 목록은 계정·조직이 허용한 경로에서만 단가를 선택합니다.

discount_percent 는 현재 모든 사용자에게 적용되는 공개 프로모션 할인율입니다. 모델 전용 프로모션이 전체 모델 프로모션보다 우선하며, 적용 중인 프로모션이 없으면 null 입니다.

정가와 표시 할인율 (`pricing.list` / `pricing.discount_percent`)

pricing.list 는 프로바이더가 공시한 정가(할인 적용 전)이며, 위 pricing.input_per_1m 등 표시 단가와 같은 키만 존재할 때 채워집니다. 정가와 표시가는 모두 마크업을 포함하지 않습니다. 공개 카탈로그의 pricing은 제공 가능한 엔드포인트의 최저 단가를 표시하며 실제 청구액은 싣지 않습니다. 정가가 없는 모델은 pricing.list 필드 자체가 없습니다.

pricing.discount_percent 는 pricing.list 의 각 키에 대해 (1 − 표시가/정가) × 100 을 계산해, 비교 가능한 모든 단가가 할인된 경우에만 가장 낮은 할인율을 표시합니다. 할인되지 않은 단가는 0%로 포함하므로 캐시만 할인된 모델에 전체 할인율을 표시하지 않습니다. 일부 단가만 할인된 경우에는 pricing.list를 유지하고 pricing.discount_percent는 생략합니다. 할인된 단가가 하나도 없으면 두 필드 모두 생략합니다.

⚠️ 이 필드는 최상위 discount_percent(everyais 프로모션 할인)와 다른 축입니다. pricing.discount_percent 는 프로바이더 정가 대비 표시가의 할인율이고, 최상위 discount_percent 는 현재 적용 중인 everyais 프로모션 할인율입니다. 두 값은 서로 독립적이며 동시에 존재할 수 있습니다.

json

{
  "pricing": {
    "unit": "per_1m_tokens",
    "input_per_1m": 0.75,
    "output_per_1m": 3.75,
    "cache_read_per_1m": 0.075,
    "list": {
      "input_per_1m": 1.5,
      "output_per_1m": 7.5,
      "cache_read_per_1m": 0.15
    },
    "discount_percent": 50
  }
}

표시 메타 필드

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: 검색 과금 1건당 기준 원가(USD). Google은 실행 쿼리당, Z.AI는 검색 활성화 요청당입니다. 미지원이거나 공개 기준 원가가 없으면 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이고 웹 검색은 지원하지 않습니다.

GET /v1/models/{model}

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

text

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

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

학습 사용과 장문 가격

training_use는 공급사의 프롬프트·출력 학습 사용 여부입니다. never(학습 사용 없음), opt_in(학습 사용 동의 필요), mixed(두 경로 존재), none(활성 경로 없음) 중 하나입니다. 커뮤니티 공급과는 별개의 설정이며 기본값은 꺼짐입니다. 조직 키는 조직의 동의를 따릅니다. 동의하지 않으면 학습 전용 모델은 키의 목록에서 빠집니다. Chat·Messages·Responses에서 호출 가능한 후보가 없으면 404 model_not_found입니다.

pricing.long_context가 있으면 입력 토큰이 threshold_tokens를 초과할 때 다른 단가 구간이 적용됩니다. 기본 구간의 최저 단가는 상위 pricing.input_per_1m / pricing.output_per_1m입니다. 장문 구간은 pricing.long_context.input_per_1m / output_per_1m이며, long_context.base_input_per_1m / base_output_per_1m은 장문 가격의 호환 별칭입니다. 카탈로그 가격은 청구액 견적이 아닙니다. 계정 요율이 적용된 실제 비용은 응답 비용 헤더와 사용량에서 확인하세요.