Roboflow API 키 찾기
Roboflow API 및 Roboflow Inference로 인증할 API 키를 찾으세요
API 키는 다음 위치에 있습니다 app.roboflow.com/settings/api, 설정 아래의 "API Keys"에 있습니다.
키에는 두 가지 종류가 있습니다:
비공개 API 키: 다음을 위한 자격 증명입니다: REST API, Python SDK, CLI 그리고 Roboflow Inference. 비밀번호처럼 취급하세요. 작업공간의 데이터와 모델에 대한 접근 권한을 부여합니다.
퍼블리시 가능한 키: 다음 형식의 비밀이 아닌 키
rf_<workspaceId>브라우저 및 엣지 코드용이며, 다음과 같은 경우에 사용됩니다:inference.js. 추론을 실행하고 모델을 다운로드할 수 있을 뿐, 그 외에는 할 수 없습니다. 자세한 내용은 공개 키.
키는 작업공간에 속합니다. 작업공간의 비공개 프로젝트에 접근하려면 해당 작업공간의 키를 사용하세요.

"Generate New Key"를 클릭하여 키를 만들거나, 이미 가지고 있는 키를 복사하세요. 키 이름 지정, 교체, 보호 또는 철회에 대해서는 대시보드에서 API 키 관리. 키가 노출되었다면 교체하세요: 자세한 내용은 API 키 교체.
Roboflow Inference와 함께 키 사용하기
API 키를 사용하면 Roboflow에서 학습한 모델, Roboflow Universe의 공개 모델, 그리고 호스팅된 추론 API에 접근할 수 있습니다. 사용할 때 이를 전달하는 방법은 여러 가지가 있습니다. Roboflow Inference.
환경 변수
권장 방법은 다음을 설정하는 것입니다 ROBOFLOW_API_KEY 환경에. 대부분의 터미널에서는:
그 터미널 세션에서 실행하는 모든 명령은 이후 이 키에 접근할 수 있습니다. 자세한 내용은 환경 변수 CLI와 SDK가 읽는 다른 변수들에 대해서는.
Python
Python에서 Inference를 사용할 때 키는 키워드 인수로 전달할 수 있습니다:
HTTP 요청
서버를 직접 호출할 때는 키를 다음 방식으로 보내세요: Authorization: Bearer 헤더. 헤더를 사용하면 URL, 접근 로그, 브라우저 기록에 키가 남지 않으며, 모든 경로에서 동일하게 작동합니다:
셀프 호스팅 서버는 Inference 1.5.0 릴리스부터 이 헤더를 읽습니다. 호스팅 API도 마찬가지로 이를 허용합니다.
키를 URL 매개변수(?api_key=...) 또는 다음과 같이 전달하는 것은 api_key 요청 페이로드의 필드는 기존 방식입니다. 모든 서버 버전에서 여전히 작동하지만, 새 코드에는 권장되지 않습니다:
여러 채널에 키가 전달되면, 쿼리 매개변수가 헤더보다 우선하고 헤더는 본문 필드보다 우선합니다.
Python SDK를 사용할 때는 헤더를 직접 만들기보다 클라이언트에서 전송 방식을 한 번 설정하세요: 자세한 내용은 API 키 전송.
Docker
Inference Server를 로컬에서 Docker 컨테이너로 실행하는 경우, 키를 다음에 제공하세요: docker run 명령:
그 서버로 전송되는 요청에서는 다음을 생략할 수 있습니다: api_key 요청 페이로드에서.
마지막 업데이트
도움이 되었나요?