Source: https://aiprimetech.io/ko/docs/api-reference/models-endpoint/ [홈](/ko/) / [문서](/ko/docs/) / 모델 엔드포인트 # 모델 엔드포인트 GET /v1/models — 사용 중인 키로 호출할 수 있는 모델 ID를 정확히 확인하세요. 페이지 복사 [ Markdown으로 보기](/ko/docs/api-reference/models-endpoint.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/models-endpoint.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/models-endpoint.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) 기준이 되는 공식 목록입니다. 여기에 없는 ID는 해당 키로 호출할 수 없습니다. 문서나 블로그 게시물을 보고 ID를 추측하지 마세요. ``` Copycurl https://aiprimetech.io/v1/models \ -H "Authorization: Bearer $CLAUDEAPIKEY" ``` ## 응답 ``` Copy{ "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를 이 목록과 대조하여 검증하고, 첫 사용자 요청에서 실패하는 대신 시작 시 명확한 오류를 표시하며 중단하세요. ``` Copyimport 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" ``` [모델가격 및 컨텍스트 윈도](/ko/docs/getting-started/models/)[오류model_not_found의 의미](/ko/docs/api-reference/errors/) [이전Chat Completions API](/ko/docs/api-reference/chat-completions/)[다음스트리밍](/ko/docs/api-reference/streaming/)