사용 가능한 모델 API 조회

1ZheAI가 관리하는 문서입니다. 출처 및 수정 사항.

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 고객 지원으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

먼저 모델을 조회한 후 요청을 작성합니다. 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. 콘솔 모델 카탈로그에서 해당 모델의 인터페이스 유형을 확인합니다.
3. 최소 텍스트 요청으로 검증한 후 이미지, 도구 또는 기타 매개변수를 점진적으로 추가합니다.

모델 목록은 실시간 상태 점검이 아니며 모든 매개변수 제한을 포함하지 않습니다. 모델이 보이지만 일시적으로 사용 가능한 업스트림이 없으면 요청이 실패할 수 있습니다. 공식 웹사이트의 HTTP 가용성 모니터링도 각 모델이 성공적으로 추론할 수 있음을 의미하지 않습니다.

목록이 비어 있거나 모델이 없는 경우

키의 모델 제한과 그룹을 확인하세요. 공개 가격 페이지에 표시된 모델이 모든 키에 열려 있는 것은 아닙니다. 401은 키 상태를 먼저 확인하고, 403은 접근 조건을 확인하세요. 자세한 단계는 오류 코드 및 문제 해결을 참조하세요.

모델 계열 및 선택 권장 사항은 지원되는 모델을 참조하세요.