모델 · Ephemeral 문서

모델 카탈로그는 실행이 사용할 수 있는 모델과, 실행에서 모델을 지정하지 않을 때 적용되는 기본값을 나열합니다. API 키가 필요하지 않습니다.

GET/v1/models

이 설치본의 카탈로그를 반환합니다.

응답

itemsarray

지원하는 모델. ID순으로 정렬됩니다.

default_modelstring

실행에 model 필드가 없을 때 사용하는 모델.

custom_models_allowedboolean

실행이 items에 없는 모델을 지정할 수 있는지 여부.

각 항목

idstring

anthropic/claude-haiku-5.5처럼 model로 전달하는 값.

namestring

표시 이름.

context_lengthinteger

공급자가 공개한 경우 토큰 단위의 컨텍스트 윈도.

pricingobject

공급자 가격. 토큰당 미국 달러를 10진수 문자열로 나타냅니다. prompt는 입력, completion은 출력입니다.

supported_parametersstring[]

공개된 경우 공급자가 이 모델에서 지원하는 요청 파라미터.

터미널

curl $EPHEMERAL_URL/v1/models

JSON

{
  "items": [
    {
      "id": "anthropic/claude-haiku-5.5",
      "name": "Anthropic: Claude Haiku 5.5",
      "context_length": 1000000,
      "pricing": {
        "prompt": "0.0000001",
        "completion": "0.0000005",
        "input_cache_read": "0.00000001",
        "input_cache_write": "0.000000125",
        "input_cache_write_1h": "0.0000002",
        "overrides": [{ "min_prompt_tokens": 100000, "prompt": "0.0000005", "completion": "0.0000025" }]
      },
      "supported_parameters": ["max_tokens", "reasoning", "tool_choice", "tools"]
    }
  ],
  "default_model": "anthropic/claude-haiku-5.5",
  "custom_models_allowed": false
}

호스팅 카탈로그

호스팅 서비스의 카탈로그에는 Ephemeral이 안전하게 청구할 수 있는 모델이 나열됩니다. 입력과 출력 토큰 가격이 있고, 미리 상한을 정할 수 없는 다른 요금이 없는 모델이 목록에 포함됩니다. 캐시된 입력과 긴 컨텍스트 가격 구간(overrides)은 문제가 없습니다. 각 호출은 모델의 가장 비싼 구간으로 승인되고 공급자가 보고한 금액으로 청구됩니다. 공급자가 모델이 지원하는 파라미터를 공개한 경우, 에이전트가 도구 호출로 동작하므로 그 목록에 tools가 있어야 합니다. custom_models_allowed는 false입니다.

카탈로그는 1분 동안 캐시됩니다. 가격은 모델을 호출하기 전마다 다시 확인하며, 각 호출은 현재 가격으로 실행 예산에 대해 승인됩니다. 모델이 조건을 더 이상 충족하지 않으면 그 모델에 대한 호출이 거부되고 실행이 실패합니다. 예산과 결제를 참고하세요.

호스팅 실행은 텍스트만 보냅니다. 모델에 대한 이미지, 오디오, 파일 입력은 거부됩니다.

셀프 호스팅 카탈로그

셀프 호스팅 설치본은 설정된 기본 모델만 나열하며, custom_models_allowed는 true입니다. 실행은 추론 엔드포인트가 받아들이는 어떤 모델 ID든 지정할 수 있습니다. 카탈로그는 추론 자격 증명을 조회하거나 노출하지 않습니다.