ApiKey 생성 및 관리 튜토리얼
ApiKey는 NextHub 서비스를 호출하기 위한 '통행증'이며, 어떤 도구를 설정할 때도 반드시 입력해야 합니다.
ApiKey 생성
1. 콘솔에 로그인하여 'ApiKey 관리' 찾기
nexthub.cc 콘솔에 로그인한 뒤, 왼쪽 패널에서 'ApiKey 관리'를 클릭합니다.
2. 'ApiKey 생성' 클릭
ApiKey 관리 페이지에서 'ApiKey 생성' 버튼을 클릭하고, 이름을 입력한 뒤 생성을 확인합니다.
3. 필요에 따라 선택 파라미터 설정
ApiKey 생성 시 다음과 같은 항목도 설정할 수 있습니다. 한도 상한, 만료 시간, IP 화이트리스트 / 블랙리스트, 5시간 / 일일 / 주간 단위의 속도 제한. 입력이 확실하지 않다면 기본값을 유지하면 됩니다.
4. 생성할 때 올바른 그룹을 선택하세요
그룹마다 사용할 수 있는 모델과 배율이 다르며, 잘못된 그룹을 선택하면 원하는 모델에 접근하지 못할 수 있습니다. 사용할 모델에 따라 해당 그룹을 선택하세요. Claude 시리즈는 claude code 그룹(0.37x, 클라이언트 제한 없음), 더 높은 안정성과 캐시 적중률을 원한다면 Claude Max 그룹(0.5x), Amazon Bedrock 회선이 필요하면 Claude-AWSB 그룹(0.7x), GPT / Codex 시리즈는 GPT-Azure 그룹(0.47x), 더 낮은 가격을 원한다면 GPT-Pro 그룹(0.11x, 이미지 생성 불가), Gemini는 예산에 따라 Gemini-aistudio(0.28x)와 Gemini-Vertex(0.49x) 중에서 선택, Grok 시리즈는 Grok 그룹(0.55x), 중국산 오픈소스 모델은 国产模型组(0.15x).
자주 발생하는 오류 해결
'모델을 사용할 수 없음' 또는 '요청이 거부됨'이 표시될 때의 확인 순서
- 호출하는 모델이 해당 ApiKey에서 선택한 그룹에 속하는지 확인합니다(채널과 모델 참고)
- 모델 ID 표기가 모델 목록과 일치하는지 확인합니다
- 한도 또는 잔액이 부족하면
429가 표시됩니다. 계정의 한도와 잔액을 확인하세요