> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/models/ko/supported-models/yolov5.md).

# YOLOv5

YOLOv5 모델 제품군을 서버리스 클라우드 API를 통해 사용

기존 YOLOv5 모델은 다음을 통해 계속 사용할 수 있습니다. [서버리스 클라우드 API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api) 및 [자체 호스팅 추론](https://docs.roboflow.com/deployment/self-hosted/self-hosted). YOLOv5에 대한 새로운 가중치 업로드 및 학습은 Roboflow에서 지원되지 않습니다. 지원되는 업로드 계열은 다음을 참조하세요: [사용자 정의 가중치 업로드](https://docs.roboflow.com/models/ko/model-weights/upload-custom-weights.md).

모델을 Roboflow 외부에서 학습할 때 YOLOv5 입력 크기가 설정됩니다(일반적인 값: 640x640 또는 1280x1280).

## YOLOv5 API

{% stepper %}
{% step %}

### API 키 받기

Roboflow 계정을 만들고, 다음에서 키를 찾으세요: [Roboflow API 설정 페이지](https://app.roboflow.com/settings/api) 그리고 셸에서 사용할 수 있도록 설정하세요:

```bash
export ROBOFLOW_API_KEY="your-key-here"
```

{% endstep %}

{% step %}

### 종속 항목 설치

SDK와 [supervision](https://supervision.roboflow.com/) 을 디코딩 및 주석 처리를 위해 설치하세요:

```bash
pip install -U inference-sdk supervision
```

{% endstep %}

{% step %}

### 모델 실행

다음을 대체하세요: `{workspace}/{model-slug}` 이미 업로드된 YOLOv5 모델의 ID(참조 [버전, 학습 및 모델](https://docs.roboflow.com/models/ko/versions-trainings-and-models.md)).

```python
import os
import cv2
import supervision as sv
from inference_sdk import InferenceHTTPClient, InferenceConfiguration

image = sv.load_image_from_url("https://media.roboflow.com/quickstart/traffic.jpg")

client = InferenceHTTPClient(
    api_url="https://serverless.roboflow.com",
    api_key=os.environ["ROBOFLOW_API_KEY"],
).configure(InferenceConfiguration(api_key_transport="header"))
result = client.infer(image, model_id="your-workspace/your-model-slug")

detections = sv.Detections.from_inference(result)

annotated = sv.BoxAnnotator().annotate(image.copy(), detections)
annotated = sv.LabelAnnotator().annotate(annotated, detections)

cv2.imwrite("annotated.png", annotated)
```

{% endstep %}
{% endstepper %}

{% hint style="info" %}
설정 `api_url` 을 배포 대상에 맞게 설정하세요:

* `https://serverless.roboflow.com` 서버리스 클라우드 API용입니다.
* `http://localhost:9001` 로컬 [추론](https://docs.roboflow.com/deployment/self-hosted/self-hosted) 서버.
* 귀하의 [전용 배포](https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments) 비공개 엔드포인트의 URL입니다.
  {% endhint %}

## 라이선스

YOLOv5는 AGPL-3.0 라이선스로 배포됩니다. 상업적 사용에 의미하는 바는 다음과 같습니다:

* **Roboflow 클라우드에서는:** 무료 플랜을 포함한 모든 사용자에게 상업용 라이선스가 포함됩니다.
* **자체 호스팅의 경우:** Enterprise 라이선스 추가 옵션이 필요하거나, 애플리케이션을 AGPL-3.0에 따라 오픈 소스로 공개해야 합니다.
* **보다 자유로운 대안:** [RF-DETR](https://docs.roboflow.com/models/ko/supported-models/rf-detr.md) 은 Apache 2.0 라이선스이며, 어디서든 상업적 용도로 무료로 사용할 수 있습니다.

다음을 참조하세요: [Roboflow의 Ultralytics 라이선스](https://roboflow.com/ultralytics) 자세한 내용은.
