Roboflow API 키 찾기

Roboflow API 및 Roboflow Inference로 인증하기 위한 API 키를 찾으세요.

API 키를 확인할 수 있는 곳은 app.roboflow.com/settings/api

---

API 키에는 두 가지 종류가 있습니다:

• 비공개 API 키: Roboflow API와 Roboflow Inference

• 공개 / 게시 가능 API 키: 사용 대상 inference.js , JavaScript 추론 SDK입니다

API 키는 워크스페이스에 범위가 지정되므로, 해당 워크스페이스의 비공개 프로젝트에 접근하려면 그 워크스페이스에 연결된 API 키를 사용해야 합니다.

새 키를 발급하려면 "Generate New Key"를 클릭하거나, 이미 만든 키를 복사하세요.

비공개 API 키는 반드시 비밀로 유지하세요. 비밀번호처럼 취급하세요. 이 키는 소지자에게 워크스페이스의 데이터와 모델에 대한 접근 권한을 부여합니다.

만약 실수로 워크스페이스에 접근할 권한이 없는 사람에게 키를 노출했다면, "Roll API Key"를 클릭하세요. 그러면 이전 API 키가 비활성화되고 새 키가 생성됩니다.

여러 API 키

Enterprise 요금제의 워크스페이스는 여러 API 키를 생성할 수 있어, 전체 운영 워크플로를 방해하지 않고도 환경을 분리하고 특정 배포나 인력의 접근 권한을 즉시 철회할 수 있습니다.

Enterprise 워크스페이스를 위한 여러 API 키 옵션

또한 범위 지정 API 키 를 Enterprise 고객을 위한 애드온으로 제공합니다.

Roboflow Inference에서 키 사용하기

API 키를 사용하면 Roboflow에서 학습한 모델, Roboflow Universe의 공개 모델, 그리고 호스팅된 추론 API에 접근할 수 있습니다. 사용할 때 키를 제공하는 방법은 여러 가지가 있습니다 Roboflow Inference.

환경 변수

권장하는 방법은 ROBOFLOW_API_KEY 를 환경 변수로 설정하는 것입니다. 대부분의 터미널에서는:

export ROBOFLOW_API_KEY=YOUR_API_KEY

그런 다음 해당 터미널 세션에서 실행되는 모든 명령은 키에 접근할 수 있습니다. 환경 변수 를 참조하여 CLI와 SDK가 읽는 다른 변수들을 확인하세요.

Python

Python에서 Inference를 사용할 때는 키를 키워드 인수로 전달할 수 있습니다:

from inference import get_model

model = get_model(model_id="...", api_key="YOUR_API_KEY")

키가 환경에 설정되어 있으면, 인수로 전달할 필요가 없습니다: model = get_model(model_id="...").

HTTP 요청 페이로드

서버를 직접 호출할 때는 경로에 따라 키를 URL 매개변수로 전달하거나 요청 페이로드의 일부로 전달하세요:

import requests

my_api_key = "YOUR_API_KEY"

url = f"http://localhost:9001/soccer-players-5fuqs/1?api_key={my_api_key}"
response = requests.post(url)

url = "http://localhost:9001/infer/object_detection"
payload = {
    "api_key": my_api_key,
    "model_id": "soccer-players-5fuqs/1",
}
response = requests.post(url, json=payload)

Docker

로컬에서 Docker 컨테이너로 Inference Server를 실행하는 경우, 키를 docker run 명령에 제공하세요:

docker run -it --rm --network=host -e ROBOFLOW_API_KEY=YOUR_API_KEY roboflow/roboflow-inference-server-cpu:latest

해당 서버로 전송되는 요청에서는 api_key 를 요청 페이로드에서 생략할 수 있습니다.

기본적으로 자체 호스팅 서버에는 API 키가 필요하지 않습니다. 컨테이너에 키를 설정해도 누가 서버를 호출할 수 있는지 제한되지는 않습니다. 인증을 적용하려면 자체 호스팅 서버 보안 설정 을 참조하세요.