환경 변수

Roboflow CLI와 Python SDK가 읽는 환경 변수.

Roboflow CLI와 Python SDK는 소수의 환경 변수를 읽습니다. 셸이나 CI 환경에 이를 설정하면 모든 명령마다 자격 증명과 구성을 전달할 필요가 없습니다.

자체 호스팅된 추론 서버 는 별도로, 훨씬 더 많은 변수 집합으로 구성됩니다. 참조: 추론 서버 환경 변수.

ROBOFLOW_API_KEY

Roboflow API 키입니다. 다음에서 사용됩니다:

• CLI - 모든 명령은 다음 경우에 이것으로 대체됩니다 --api-key / -k 가 전달되지 않았을 때.

• Python SDK - roboflow.Roboflow() (인수 없이)와 대부분의 어댑터 함수는 명시적인 키가 제공되지 않을 때 이를 읽습니다.

export ROBOFLOW_API_KEY=rf_xxxxx

import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY를 자동으로 가져옵니다

키는 다음에서 찾을 수 있습니다: Roboflow 웹 앱의 Settings → API Key에서.

ROBOFLOW_CONFIG_DIR

CLI가 인증 자격 증명과 설정된 기본 작업공간을 저장하는 위치를 재정의합니다. 기본값: ~/.config/roboflow/.

export ROBOFLOW_CONFIG_DIR=/etc/roboflow
roboflow login
# 자격 증명은 /etc/roboflow/config.json에 저장됩니다

CI, 컨테이너 빌드, 또는 동일한 머신에서 여러 Roboflow 계정을 나란히 실행할 때 유용합니다.

API_URL

SDK와 CLI가 REST API 요청을 보내는 기본 URL을 재정의합니다. 기본값: https://api.roboflow.com.

이것을 설정할 필요는 없습니다. 이는 사전 프로덕션 환경에 대한 Roboflow 내부 테스트용으로 존재합니다.

DEDICATED_DEPLOYMENT_URL

dedicated-deployments 서비스의 기본 URL을 재정의합니다. 기본값: https://roboflow.cloud.

이것을 설정할 필요는 없습니다. 이는 사전 프로덕션 환경에 대한 Roboflow 내부 테스트용으로 존재합니다.

우선순위

같은 값을 여러 방식으로 제공할 수 있을 때, 우선순위 순서는 다음과 같습니다(높은 순서부터):

1. 명시적 플래그 - 예: --api-key CLI 명령에서, 또는 api_key Python 함수의 인수.

2. 환경 변수 - 예: ROBOFLOW_API_KEY.

3. 디스크에 저장된 구성 - 예: ~/.config/roboflow/config.json CLI가 저장한 자격 증명용.

4. 내장 기본값 - 다음과 같은 비밀이 아닌 값에만 해당: API_URL.

CI / 에이전트 권장 사항

CI 또는 AI 에이전트 환경에서는 다음을 사용하는 것이 좋습니다: ROBOFLOW_API_KEY 보다 roboflow login. 환경 변수 경로는 대화형 프롬프트가 필요 없고, 디스크 상태도 남기지 않으며, 비밀 저장소에서 키를 교체하면 깔끔하게 회전됩니다.

# GitHub Actions 예시
env:
  ROBOFLOW_API_KEY: ${{ secrets.ROBOFLOW_API_KEY }}