1. 내 키로 쓸 수 있는 모델 찾기
GET /v1/models는 키의 허용 모델과 계정·조직 정책을 반영한 목록을 돌려줍니다.
공개 모델 페이지에는 별도 동의가 필요한 모델도 보이므로 두 목록이 다를 수 있습니다. 요청에는 응답의 id를 그대로 쓰세요.
2. 모델이 지원하는 기능 확인
| 필드 | 알 수 있는 것 |
|---|---|
category · supported_endpoints | 모델 종류(LLM / IMAGE / VIDEO)와 호출할 수 있는 엔드포인트 |
capabilities | 스트리밍, 도구 호출, 이미지 입력, JSON 출력, strict 스키마, 웹 검색, 마스크 편집 등의 지원 여부 |
limits | 컨텍스트 한도와 모델이 받는 값(추론 강도, 크기, 품질, 길이, 이미지 수). 필드가 없으면 확인되지 않은 것입니다 |
available | 지금 호출할 수 있는지 |
필드 전체 설명은 GET /v1/models에 있습니다. 모델별 상한은 API 공통 상한보다 낮을 수 있습니다. Messages와 Responses 요청은 Chat 요청으로 변환해 처리하므로 공급사 고유 기능 중 일부는 지원하지 않습니다.
파라미터 정책
선택 모델의 parameter_profile에서 필수 입력(required), 기본값(defaults), 지원값(parameters), 함께 쓸 수 없는 조합(combinations)을 확인하세요. GET /v1/models의 capabilities·limits에도 같은 정보가 요약돼 있습니다.
모델이 지원하지 않는 값을 보냈을 때의 동작은 everyais.parameter_policy로 정합니다.
everyais.parameter_policy | 동작 |
|---|---|
auto (기본) | 지원하지 않는 샘플링 옵션(temperature·top_p·penalty·top_k)과 seed·user는 빼고 보내고, 범위를 넘는 값은 허용 범위 안으로 낮춥니다. 그 밖의 미지원 옵션(stop·logprobs·도구 등)은 400 |
strict | 지원하지 않는 값이나 조합을 보내면 400 unsupported_parameter |
바꾼 내용은 응답의 x_everyais.parameter_warnings(param, action, reason, applied)에 있습니다.
도구, 마스크, 응답 형식은 조정하지 않습니다. 일부 공급사에서만 지원하는 옵션은 parameter_constraints와 parameter_profile.routes에 표시됩니다.
3. 접근 정책 확인
커뮤니티 공급(supply)과 공급사의 학습 사용(training_use)은 각각 동의해야 쓸 수 있고, 둘 다 기본으로 꺼져 있습니다.
개인 키는 계정 설정을, 조직 키는 조직 설정을 따릅니다.
- 커뮤니티 공급이나 학습 사용 조건으로만 제공되는 모델은 동의가 없으면 Chat·Messages·Responses에서 404
model_not_found입니다. - 두 방식이 섞인 모델(
mixed)은 허용된 공급사로만 요청을 보냅니다. - 원하는 모델이 목록에 없으면 키의 허용 모델, 두 동의 설정, 모델이 지금 제공 중인지 확인하세요.