모델 엔드포인트
GET /v1/models — 사용 중인 키로 호출할 수 있는 모델 ID를 정확히 확인하세요.
기준이 되는 공식 목록입니다. 여기에 없는 ID는 해당 키로 호출할 수 없습니다. 문서나 블로그 게시물을 보고 ID를 추측하지 마세요.
curl https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"
응답
{
"object": "list",
"data": [
{"id": "claude-opus-4-8", "object": "model", "owned_by": "anthropic"},
{"id": "claude-sonnet-4-6", "object": "model", "owned_by": "anthropic"},
{"id": "gpt-5.5", "object": "model", "owned_by": "openai"}
]
}
실용적인 활용 사례
- 상태 확인. 200은 다른 문제를 디버깅하기 전에 기본 URL과 키가 모두 올바른지 확인해 줍니다.
- 모델 선택 목록 구성. 시간이 지나면 낡아지는 목록을 하드코딩하는 대신 시작 시 ID를 읽어오세요.
- 오타 감지. 설정된 모델 ID를 이 목록과 대조하여 검증하고, 첫 사용자 요청에서 실패하는 대신 시작 시 명확한 오류를 표시하며 중단하세요.
import os, httpx
r = httpx.get(
class="s">"https://aiprimetech.io/v1/models",
headers={class="s">"Authorization": fclass="s">"Bearer {os.environ['CLAUDEAPIKEY']}"},
timeout=20,
)
r.raise_for_status()
ids = [m[class="s">"id"] for m in r.json()[class="s">"data"]]
assert class="s">"claude-sonnet-4-6" in ids, class="s">"configured model not available on this key"