--- title: "사용 가능한 모델 API 조회" description: "GET /v1/models의 두 가지 응답 형식, 모델 ID 읽기, 그리고 모델 가시성과 실제 호출 가능성이 다른 점." headingIds: {"OpenAI 형식":"section-1","Anthropic 형식":"section-2","조회 결과 사용 방법":"section-3","목록이 비어 있거나 모델이 없는 경우":"section-4"} --- 먼저 모델을 조회한 후 요청을 작성합니다. `GET https://1zheai.com/v1/models`은 현재 키, 그룹 및 모델 제한 하에서 볼 수 있는 모델을 반환하며, 추론 요청을 보낼 필요가 없습니다. ## OpenAI 형식 ```bash curl --fail-with-body --connect-timeout 10 --max-time 30 \ https://1zheai.com/v1/models \ -H "Authorization: Bearer $ONEZHE_API_KEY" ``` 아래는 간소화된 구조 예시이며, 목록은 실제 반환값을 따릅니다: ```json { "object": "list", "data": [{"id": "gpt-5.6-sol", "object": "model"}] } ``` `jq`이 설치된 경우 요청 뒤에 `| jq -r '.data[].id'`을 추가할 수 있으며, 한 줄에 모델 ID 하나씩 표시됩니다. 공개 가격 인터페이스의 `model_name`과 여기의 `id`을 혼동하지 마세요. ## Anthropic 형식 다음 두 요청 헤더를 사용하면 동일한 경로가 Anthropic 스타일의 데이터를 반환합니다: ```bash curl --fail-with-body https://1zheai.com/v1/models \ -H "x-api-key: $ONEZHE_API_KEY" \ -H "anthropic-version: 2023-06-01" ``` `data[].id`, `data[].display_name`, `has_more`에 주목하세요. 인증 방식을 전환한 후에도 다른 응답 구조로 계속 파싱하지 마세요. ## 조회 결과 사용 방법 1. `data[].id`에서 전체 ID를 복사하고 대소문자, 하이픈 및 날짜 접미사를 그대로 유지합니다. 2. [콘솔 모델 카탈로그](https://1zheai.com/model-catalog?lng=ko)에서 해당 모델의 인터페이스 유형을 확인합니다. 3. 최소 텍스트 요청으로 검증한 후 이미지, 도구 또는 기타 매개변수를 점진적으로 추가합니다. 모델 목록은 실시간 상태 점검이 아니며 모든 매개변수 제한을 포함하지 않습니다. 모델이 보이지만 일시적으로 사용 가능한 업스트림이 없으면 요청이 실패할 수 있습니다. 공식 웹사이트의 HTTP 가용성 모니터링도 각 모델이 성공적으로 추론할 수 있음을 의미하지 않습니다. ## 목록이 비어 있거나 모델이 없는 경우 키의 모델 제한과 그룹을 확인하세요. 공개 가격 페이지에 표시된 모델이 모든 키에 열려 있는 것은 아닙니다. 401은 키 상태를 먼저 확인하고, 403은 접근 조건을 확인하세요. 자세한 단계는 [오류 코드 및 문제 해결](/ko/docs/troubleshooting/)을 참조하세요. 모델 계열 및 선택 권장 사항은 [지원되는 모델](/ko/docs/models/)을 참조하세요.