For the complete documentation index, see llms.txt. This page is also available as Markdown.

인증

Roboflow에서 인증이 작동하는 방식 - API 키, 공개 가능 키, 범위 제한 키, OAuth.

Roboflow API 및 Roboflow Inference에 대한 모든 요청은 인증됩니다. 이 섹션에서는 Roboflow가 제공하는 자격 증명 유형, 각 유형을 사용할 때, 그리고 요청에 필요한 ID를 어디에서 찾을 수 있는지 설명합니다.

key

API 키는 다음에서 찾을 수 있습니다: app.roboflow.com/settings/api.

자격 증명 유형

Roboflow는 여러 종류의 자격 증명을 지원하며, 각 자격 증명은 서로 다른 상황에 적합합니다:

  • 비공개 API 키 - 기본 워크스페이스 자격 증명입니다. 워크스페이스의 데이터, 모델, 프로젝트에 대한 전체 액세스를 제공하므로 비밀번호처럼 취급하고 서버 측에 보관하세요. 다음에 사용하세요: REST API, Python SDK, CLI, 그리고 자체 호스팅된 추론로 구성됩니다. Roboflow API 키 찾기.

  • 공개 키 - 다음 형식의 비밀이 아닌 자격 증명입니다: rf_<workspaceId>, 브라우저나 다음과 같은 엣지 코드에 포함해도 안전합니다: inferencejs. 이는 추론 및 모델 다운로드 전용이며, 워크스페이스 ID에서 파생되므로 교체하거나 취소할 수 없습니다. 다음을 참조하세요: 공개 키.

  • 범위 지정 API 키 - 특정 권한(예: 추론은 가능하지만 모델 관리는 불가)으로 제한되는 Enterprise 자격 증명이며, 선택적으로 특정 프로젝트 폴더로도 제한할 수 있습니다. 다음을 참조하세요: 범위 지정 API 키.

  • OAuth 2.1 (Roboflow로 로그인) - 사용자가 자신의 Roboflow 계정으로 애플리케이션에 로그인하고, PKCE가 포함된 인증 코드 흐름을 사용하여 사용자를 대신해 앱에 범위가 지정된 액세스 권한을 부여할 수 있습니다. 다음을 참조하세요: Roboflow로 로그인(시작하기).

키 관리

  • Roboflow API 키 찾기 - 키가 어디에 저장되는지, 비공개인지 공개인지, 그리고 유출된 키를 교체하는 방법.

  • API 키 관리 - REST API를 통해 키를 프로그래밍 방식으로 생성, 목록 조회, 업데이트, 보호, 비활성화, 폐기할 수 있으며, 또한 roboflow api-key CLI 또는 MCP 서버를 통해.

  • 범위 지정 API 키 - 특정 권한으로 제한된 Enterprise 키를 발급합니다.

Roboflow로 로그인(OAuth)

ID 찾기

대부분의 API 호출에는 키 이상의 정보가 필요합니다. 어떤 워크스페이스, 프로젝트, 모델 버전에 대해 작업할지 알아야 합니다.

각 호스트에서 허용되는 헤더 및 쿼리 매개변수 형식은 다음을 참조하세요 REST API로 인증하기.

마지막 업데이트

도움이 되었나요?