Skip to main content
GET
모델 목록

소개

API 키로 사용 가능한 모든 모델을 조회합니다. 동일한 엔드포인트 https://api.gravitex.ai/v1/models는 요청 헤더에 따라 해당 플랫폼의 네이티브 형식으로 응답을 자동 반환하므로, URL을 바꾸거나 여러 통합을 유지할 필요가 없습니다.

자동 형식 감지

GravitexAI는 인증 헤더를 검사하여 클라이언트 유형을 감지하고, 공식 OpenAI / Anthropic / Gemini ListModels 스키마로 응답을 반환하므로 네이티브 SDK를 바로 사용할 수 있습니다.

형식 감지 규칙

여러 자격 증명이 함께 전달되면 우선순위는 Anthropic > Gemini > OpenAI입니다.

인증

string
OpenAI 호환 인증, 형식: Bearer sk-xxxxxxxxxx
string
Anthropic 인증 — 원시 API 키(Bearer 접두사 없음)
string
Anthropic API 버전, 예: 2023-06-01
string
Gemini 인증 — 원시 API 키

요청 예시

응답 예시

응답 필드

OpenAI 형식

Anthropic 형식

Gemini 형식

오류 처리

오류 응답 예시(OpenAI 형식):

모범 사례

  • 결과 캐싱 — 모델 목록은 자주 바뀌지 않으므로 1시간 이상 캐싱하면 불필요한 요청을 줄일 수 있습니다.
  • 시작 시 검증 — 부팅 시 한 번 호출하여 키가 유효하고 대상 모델을 사용할 수 있는지 확인하세요.
  • 권한 인식 — 반환 목록은 API 키 권한에 따라 달라지며, 키마다 다른 모델이 표시될 수 있습니다.
  • SDK 즉시 사용 — 공식 OpenAI / Anthropic / Google SDK를 사용할 때 base URL을 https://api.gravitex.ai로 지정하면 추가 어댑터 없이 동작합니다.
Python 예시 의존성:
  • OpenAI 형식: pip install openai
  • Anthropic 형식: pip install anthropic
  • Gemini 형식: pip install requests