2. API 키 생성 및 관리#
API 키는 모든 엔드포인트를 호출하는 유일한 자격 증명입니다.
API 키 발급받기(콘솔 작업 절차)#
- YiTuoToken 콘솔에 로그인합니다.
- 왼쪽 내비게이션 바에서 API 키를 클릭해 키 관리 페이지로 이동합니다.
- API 키 생성 버튼을 클릭합니다.
- 열리는 대화상자에 다음을 입력합니다:
- 키 이름(필수, 예: '프로덕션 환경 서비스', 용도 구분용)
- 쿼터 상한(선택, 비워 두면 무제한)
- IP 허용 목록(선택, 호출 가능한 출발 IP / CIDR 제한)
- 만료 시간(선택, 만료 후 자동 무효화)
- 사용 가능 모델 허용 목록(선택, 이 키가 호출할 수 있는 모델 범위 제한)
- 키 생성을 클릭해 제출합니다.
- 새 키 저장 대화상자가 나타납니다 — 전체 키 평문은 이때 단 한 번 표시됩니다. 키 복사를 클릭해 안전한 곳에 저장한 뒤 저장했습니다를 눌러 닫습니다.
대화상자를 닫은 뒤에는 전체 키를 다시 볼 수 없습니다. 시스템은 키의 해시만 저장하며 평문은 저장하지 않습니다. 제때 저장하지 못했다면 해당 키를 폐기하고 새로 생성하세요.
설정 가능 항목#
| 설정 | 설명 |
|---|---|
| 이름 | 용도 구분에 유용(예: '프로덕션 환경', '로컬 테스트') |
| 쿼터 상한 | 이 키가 소모할 수 있는 쿼터 상한, 소진 시 요청이 402를 반환 |
| IP 허용 목록 | 출발 IP 제한, 단일 IP와 CIDR 범위 지원(쉼표 구분) |
| 유효 기간 | 만료 후 키가 자동으로 무효화 |
| 모델 허용 목록 | 이 키가 호출할 수 있는 모델 범위 제한 |
관리 작업#
- 폐기: 키가 유출되었거나 더 이상 사용하지 않을 때 즉시 폐기합니다. 폐기 후 해당 키의 모든 요청은
401을 반환합니다. - 순환(rotate): 정기적으로 새 키를 만들고 기존 키를 단계적으로 교체해 유출 위험을 낮추는 것을 권장합니다.
보안 참고: API 키를 프런트엔드 코드, 공개 저장소, 클라이언트 앱에 하드코딩하지 마세요. 환경 변수나 백엔드 서비스로 보관해야 합니다.