API 키 발급받기
HiAPI 콘솔에서 API 키를 만들어 에이전트 도구에서 HiAPI에 연결합니다.
어떤 도구를 연결하기 전에 HiAPI 콘솔에서 API 키를 준비하세요.
- HiAPI 콘솔 → API Keys를 엽니다. 계정이 없다면 먼저 가입하세요.
- 이미 키가 있으면 그대로 사용하세요. 없다면 Create key를 클릭하고 알아보기 쉬운 이름을 지정한 뒤, 필요하면 지출 한도를 설정하세요. 지출 한도는 충전이 아니므로 계정에는 여전히 잔액이 있어야 합니다.
① 키 이름을 입력합니다. ② 필요에 따라 무제한 또는 지출 한도를 선택합니다. ③ Create key를 클릭합니다.
- 키 옆의 복사 아이콘을 클릭해 전체 HiAPI API 키를 복사합니다. 마스킹된 값을 복사하지 말고, 키를 채팅창에 붙여 넣지 마세요.
CC Switch 원클릭 가져오기를 사용하는 도구(Claude Code, Codex CLI, Codex Desktop, OpenCode)는 연결 페이지에서 키를 선택하기만 하면 됩니다. 가져오기가 키를 함께 전달하므로 복사할 것이 없습니다.
에이전트 도구는 한 작업을 끝내기 위해 모델을 연속으로 여러 번 호출하므로 보통 일반 채팅보다 비용이 더 듭니다. 이런 도구에는 별도의 키를 만들어 지출 한도를 설정하는 것을 권장합니다. 사용량을 쉽게 확인할 수 있고, 예상보다 많이 과금될 걱정이 없습니다.
가이드에서는 키를 YOUR_HIAPI_API_KEY로 표기합니다. 이 값을 자신의 키로 바꾸고, 도구가 요구하는 곳에만 붙여 넣으세요. 키 그룹과 권한은 인증을 참고하세요.