엔드포인트

모델 목록 조회

GET/v1/models

요청 예제

curl https://api.everyais.com/v1/models \
  -H "Authorization: Bearer $EVERYAIS_API_KEY"

GET /v1/models

응답 예제

JSON

{
  "object": "list",
  "data": [
    {
      "id": "everyais/claude-sonnet-5-5",
      "aliases": ["claude-sonnet-5-5"],
      "object": "model",
      "owned_by": "everyais",
      "created": 1782008704,
      "registered_at": "2026-06-21",
      "released_at": "2026-06-21",
      "updated_at": "2026-08-27T04:30:00.000Z",
      "name": "Claude Sonnet 5.5",
      "description": "추론·장문·이미지 입력을 지원하는 모델.",
      "series": "claude",
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "knowledge_cutoff": null,
      "price_search_per_query": null,
      "supply": "first_party",
      "training_use": "never",
      "category": "LLM",
      "type": "chat",
      "supported_endpoints": ["/v1/chat/completions", "/v1/messages", "/v1/responses"],
      "capabilities": {
        "streaming": true,
        "tool_use": true,
        "vision": true,
        "json_mode": true,
        "structured_outputs": true,
        "sampling": false,
        "parallel_tool_calls": true,
        "reasoning": true,
        "web_search": false
      },
      "limits": { "context_window": 1000000, "reasoning_efforts": ["low", "medium", "high", "xhigh", "max", "none"] },
      "parameter_profile": { "version": 1, "scope": "all-active-routes", "tasks": { "chat": { "status": "supported", "required": ["model", "messages"], "defaults": {}, "parameters": { "reasoning_effort": { "status": "supported", "type": "string", "allowed_values": ["low", "medium", "high", "xhigh", "max", "none"] } }, "combinations": [] } } },
      "parameter_constraints": [{ "provider": "aws-bedrock", "parameters": { "chat": { "reasoning_effort": { "supported": true, "type": "string", "allowed_values": ["low", "medium", "high", "xhigh", "max", "none"] } } } }],
      "pricing": {
        "unit": "per_1m_tokens",
        "is_free": false,
        "input_per_1m": 3.159,
        "output_per_1m": 15.795,
        "list": { "input_per_1m": 3.51, "output_per_1m": 17.55 },
        "discount_percent": 10
      },
      "discount_percent": 10,
      "available": true
    }
  ]
}

모델 불러오는 중…

모델 필드

id · aliases: 요청에 사용할 모델 ID와 별칭
name · description · series: 표시명·모델 설명·계열
category: LLM · IMAGE · VIDEO
supported_endpoints: 호출 경로
available: 현재 호출 가능 여부
input_modalities · output_modalities: 입력·출력 형식
created · registered_at · released_at: 호환 epoch·등록일·출시일
knowledge_cutoff: 확인된 지식 기준일. 미확인은 null
capabilities: 기능 지원. true 지원, false 미지원, 생략은 미확인
limits: 모델의 지원값·상한
parameter_profile.tasks: 작업별 필수 입력·기본값·지원 범위·조합

capabilities는 sampling, json_mode, structured_outputs, json_mode_with_tools, web_search_with_tools, parallel_tool_calls, image_mask를 구분합니다. limits의 reasoning_efforts, supported_sizes, supported_qualities, supported_durations, max_images는 모델별 지원값입니다. 빈 배열은 지원값 없음입니다. 미지원 값·조합은 400 unsupported_parameter이며 error.param으로 해당 필드를 확인합니다. 값을 조정하는 규칙은 모델 선택과 접근 정책의 파라미터 정책을 보세요.

가격과 접근 조건

pricing: 표시 단가. 실제 비용은 계정 요율을 적용하며 응답 비용 헤더·사용량에서 확인
pricing.is_free === true: 입력·출력·캐시 토큰 무료. 웹 검색은 별도 과금
pricing.list · pricing.discount_percent: 할인 전 가격과 모든 단가에 공통 적용되는 최소 할인율. 정가 할인과 전체 고객 프로모션이 모두 들어 있다
discount_percent: 그중 everyais 프로모션 할인율(이미 pricing 표시 단가에 반영). 공급사 경로마다 다른 할인이 있으면 최대값
pricing.variants: 변형별 key · price
pricing.long_context: 입력이 threshold_tokens를 초과하면 적용되는 단가. base_input_per_1m·base_output_per_1m은 장문 단가의 호환 별칭
price_search_per_query: 검색 1건의 기준 단가. 웹 검색 지원 여부는 capabilities.web_search로 확인
pricing.conditions: 표시가에 필요한 community_supply·training_use 동의
supply · training_use: 커뮤니티 공급·학습 사용 조건. 기본 꺼짐이며 조직 키는 조직 설정 적용

동의가 필요한 모델은 계정 설정에 따라 목록에서 제외됩니다.

GET /v1/models/{model}

모델 ID를 슬래시까지 그대로 이어 붙입니다.

http

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

없거나 접근할 수 없는 모델은 404 model_not_found입니다.