Python SDK로 인증

Roboflow API 키를 Python SDK에 전달하는 세 가지 방법 - 환경 변수, 명시적 인수, 또는 대화형 로그인입니다.

Python SDK는 API 키를 세 가지 방식으로 받습니다. 런타임에 맞는 방법을 선택하세요. 모두 결국 같은 Roboflow 객체.

옵션 1: 환경 변수(스크립트와 에이전트에 권장)

설정 ROBOFLOW_API_KEY 쉘 또는 CI 환경에서:

export ROBOFLOW_API_KEY=rf_xxxxx

import roboflow

rf = roboflow.Roboflow()  # ROBOFLOW_API_KEY를 가져옴

이 방법은 스크립트, 노트북, AI 코딩 에이전트에 가장 깔끔한 경로입니다. 대화형 프롬프트도 없고 디스크에 상태도 남지 않습니다.

옵션 2: 키를 명시적으로 전달

import roboflow

rf = roboflow.Roboflow(api_key="rf_xxxxx")

같은 프로세스에서 여러 작업 공간에 대해 여러 키를 사용할 때 유용합니다.

옵션 3: 대화형 로그인

import roboflow

roboflow.login()

브라우저에서 인증 URL을 열고, 토큰 입력을 요청한 뒤 자격 증명을 다음 위치에 저장합니다 ~/.config/roboflow/config.json. 이후의 Roboflow() 호출은(인수가 없을 때) 해당 파일에서 읽습니다.

다른 계정으로 다시 인증하거나 토큰을 새로 고치려면:

roboflow.login(force=True)

CLI의 roboflow login 동일한 디스크 상 위치에 기록하므로, 어느 도구든 한 번 인증하면 다른 도구도 자격 증명을 사용합니다.

API 키를 찾는 곳

에서 Roboflow 웹 앱, 이동하세요 설정 → API 키. 각 작업 공간에는 고유한 키가 있습니다. 사용하는 키에 따라 코드가 인증되는 작업 공간이 결정됩니다.

에 대해서는 범위가 지정된 API 키 (키를 특정 리소스나 작업으로 제한), 인증 섹션을 참고하세요.

구성 위치 재정의

자격 증명을 다음이 아닌 다른 위치에 저장해야 한다면 ~/.config/roboflow/, 다음을 설정하세요 ROBOFLOW_CONFIG_DIR:

export ROBOFLOW_CONFIG_DIR=/etc/roboflow

다음을 참조하세요 환경 변수 에 대해 SDK와 CLI가 인식하는 변수 전체 목록을 확인하세요.