주석 워크플로 관리

Python SDK를 사용해 업로드 배치와 주석 작업을 나열하고 이미지를 라벨러와 검토자에게 할당합니다.

Python SDK

프로젝트 주석 파이프라인의 기본 기능을 제공합니다: 업로드 배치를 나열하고, 주석 작업을 확인하고, 이미지를 라벨러와 리뷰어에게 할당하는 새 작업을 생성합니다.

이미지 배치 나열

업로드된 각 이미지 세트는 배치에 속합니다. 프로젝트의 배치를 나열합니다:

import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
project = rf.workspace().project("my-detector")

batches = project.get_batches()
for b in batches.get("batches", []):
    print(b["id"], b["name"], b["images"], "이미지")

단일 배치의 세부 정보를 가져옵니다:

batch = project.get_batch("<batch-id>")
print(batch)

주석 작업 나열

jobs = project.get_annotation_jobs()
for job in jobs.get("jobs", []):
    print(job["id"], job["name"], job["status"], job["annotated"], "/", job["numImages"] )

단일 작업 가져오기:

job = project.get_annotation_job("<job-id>")
print(job)

주석 작업 생성

배치의 이미지를 라벨러에게 할당합니다(작업 공간에서 역할 기반 액세스 제어가 활성화된 경우 리뷰어도 할당):

job = project.create_annotation_job(
    name="1차: 실내 프레임",
    batch_id="<batch-id>",
    num_images=100,
    labeler_email="[e-mail]",
    reviewer_email="[e-mail]",
)
print(job["id"], job["status"])

매개변수

• 이름 (str) - 작업의 표시 이름.

• batch_id (str) - 이미지가 포함된 업로드 배치의 ID.

• 이미지 수 (int) - 이 작업에 포함할 배치의 이미지 수.

• 라벨러 이메일 (str) - 레이블을 그릴 작업 공간 구성원의 이메일.

• 리뷰어 이메일 (str) - 검토할 작업 공간 구성원의 이메일입니다. RBAC가 활성화되어 있지 않으면 이를 라벨러와 동일하게 설정하세요.

주석을 프로그램 방식으로 저장

기존 CVAT 내보내기나 커밋하려는 모델 예측처럼 다른 소스의 주석이 있을 때는 Project.save_annotation 을 사용해 이미지를 직접 연결하세요.

CLI

명령줄에서 주석 배치를 나열하고, 배치 세부 정보를 확인하며, 주석 작업을 생성할 수 있습니다.

주석 배치

배치 목록

roboflow annotation batch list -p my-project

JSON 출력 시:

roboflow annotation batch list -p my-project --json

배치 세부 정보 가져오기

roboflow annotation batch get <batch-id> -p my-project

roboflow annotation batch get <batch-id> -p my-project --json

주석 작업

작업 목록

roboflow annotation job list -p my-project

roboflow annotation job list -p my-project --json

작업 세부 정보 가져오기

roboflow annotation job get <job-id> -p my-project

roboflow annotation job get <job-id> -p my-project --json

작업 생성

roboflow annotation job create -p my-project \
  --name "레이블 1차" \
  --batch <batch-id> \
  --num-images 100 \
  --labeler [e-mail] \
  --reviewer [e-mail]

옵션

플래그	설명
-p, --project	프로젝트 ID(필수)
--name	작업 이름(필수)
--batch	이미지를 가져올 배치 ID(필수)
--num-images	포함할 이미지 수(필수)
--labeler	라벨러 이메일 주소(필수)
--reviewer	리뷰어 이메일 주소(필수)

JSON 출력

모든 주석 명령은 --json 구조화된 출력용:

roboflow annotation batch list -p my-project --json | jq '.[].id'
roboflow annotation job create -p my-project --name "Job" \
  --batch abc --num-images 50 --labeler [e-mail] --reviewer [e-mail] --json

종료 코드: 0 = 성공, 1 = 오류, 2 = 인증 오류, 3 = 찾을 수 없음.