API 키

코드에서 인증에 사용하는 키를 생성하고, 권한을 좁히고, 교체합니다. 게이트웨이에 필요한 자격 증명은 키 하나뿐이며, 모든 모델과 모든 엔드포인트에 같은 키를 씁니다.

콘솔 사이드바 위치(해당 기능이 계정에 적용되면 표시됩니다): API keys 열기 ↗

진행 단계

  1. API keys를 열고 Create key를 누릅니다.
  2. 6개월 뒤에도 알아볼 수 있는 이름을 지으세요. 교체할 때 키를 구분하는 기준은 이름입니다.
  3. 키에 적용할 제한을 설정합니다. 재설정 주기가 있는 지출 한도, 허용 모델 목록, IP 허용 목록, 만료일이 있습니다. 모두 선택 사항이며, 아무것도 설정하지 않은 키는 워크스페이스가 접근 권한을 가진 모든 모델을 호출할 수 있습니다.
  4. 키를 즉시 복사해 시크릿 저장소에 보관하세요. 그런 다음 Authorization: Bearer <key> 형태로 전송합니다.

제한과 유의 사항

  • 키는 딱 한 번만 표시됩니다. 다시 확인할 방법은 없으므로, 잃어버렸다면 삭제하고 새로 만드세요.
  • 키 삭제는 즉시 적용됩니다. 교체할 때는 새 키를 만들고, 배포한 뒤, 기존 키를 삭제하는 순서를 지키세요.
  • 키는 워크스페이스에 속합니다. 워크스페이스를 전환하면 보이는 키도 바뀌며, 키가 다른 워크스페이스에 걸쳐 동작하는 일은 없습니다.
  • IP 허용 목록은 키에 정해 두는 고정 목록입니다. 새 주소가 나타날 때마다 승인하는 방식으로 쓰려면 워크스페이스에서 신뢰할 수 있는 IP를 켜세요. 허용 목록이 있는 키는 계속 자기 목록으로만 판단됩니다.

같은 기능의 API 레퍼런스: API 키