> 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/deployment/ko/roboflow-cloud/dedicated-deployments.md).

# 전용 배포

Roboflow로 비전 모델을 전용 서버에 배포하기

## 소개

전용 배포는 Roboflow가 관리하는 프라이빗 클라우드 서버로, 사용자 전용으로 할당된 리소스에서 컴퓨터 비전 모델과 워크플로를 실행합니다. 인프라를 직접 프로비저닝하거나 유지 관리하지 않고도 시간당 요금제로 추론을 제공할 수 있으며, 워크스페이스 API 키를 통해 안전하게 액세스할 수 있습니다. 개발, 테스트 또는 프로덕션 트래픽에 일관되고 전용적인 성능이 필요할 때 사용하세요.

### **전용 배포란 무엇인가요?**

전용 배포는 Roboflow가 관리하는 프라이빗 클라우드 서버로, 컴퓨터 비전 모델을 실행하도록 특별히 설계되었습니다. 여기에는 다음과 같은 모델이 포함될 수 있습니다.

* 객체 감지
* 이미지 분할
* 분류
* 키포인트 감지
* CLIP과 같은 파운데이션 모델(Roboflow에서 학습한 경우)
* Roboflow Workflows(로우코드 비전 애플리케이션)
* ...그 외에도 다양합니다!

### **전용 배포의 이점**

* **머신 비전 비즈니스 문제에 집중하고 인프라는 저희에게 맡기세요.** 클라우드 제공업체에 가입하거나, 서버를 설치하고 보안을 설정하거나, TLS 인증서를 관리하거나, 서버 관리, 패치, 업데이트 등을 걱정할 필요 없이 몇 번의 클릭만으로 추론 서비스 인프라를 시작할 수 있습니다.
* **전용 리소스:** 사용자 전용으로 할당된 클라우드 서버를 이용해 모델의 성능을 일관되게 유지할 수 있습니다.
* **보안 액세스:** 전용 배포에는 워크스페이스의 고유 API 키로 액세스할 수 있으며, 보안 통신에 HTTPS를 사용합니다.
* **간편한 통합:** 각 배포에는 다음 도메인의 하위 도메인이 할당되어 `roboflow.cloud`애플리케이션과 간편하게 통합할 수 있습니다.
* **시간당 요금:** 서버가 존재한 시간에 대해서만 요금이 부과됩니다(1분 단위로 청구).
* **자동 일시 중지 및 재개**: 설정 가능한 비활성 기간이 지나면 전용 배포가 자동으로 일시 중지됩니다.  `dev-cpu` 또는 `dev-gpu` 배포 유형의 비활성 기간은 1시간으로 고정되어 있습니다. API 키를 사용해 요청을 보내면 빠르게 재개할 수 있습니다. 이 기능은 비용을 절감하는 데 도움이 됩니다.

### API 키

전용 배포는 생성 시 사용한 워크스페이스 API 키로 실행됩니다. 해당 키를 교체하면 Roboflow가 배포를 새 키로 이전하고 계속 실행되도록 합니다. 이전에 실패하면 배포가 계속 트래픽을 처리할 수 있도록 이전 키가 활성 상태로 유지되며, 다시 키 교체를 시도할 수 있습니다.

키가 비활성화되어 있거나 해당 키의  [결제 폴더](https://docs.roboflow.com/platform/billing-and-plans/billing-folders) 가 일시 중지된 상태에서는 전용 배포에 사용되는 키를 교체할 수 없습니다. 키를 활성화하거나 폴더를 재개한 다음 키를 교체하세요.

### 추론 버전

각 배포는 다음의 버전을 실행합니다. [Roboflow Inference](https://docs.roboflow.com/deployment/ko/self-hosted/self-hosted.md). 버전을 변경하려면 프로비저닝이 완료된 후 배포 설정을 열고 "추론 버전"에서 옵션을 선택하세요.

* "최신 버전(자동 업그레이드)": 배포는 각 Inference 릴리스 후 7일 이내에, 그리고 재시작할 때마다 업그레이드됩니다.
* 버전 번호: 변경할 때까지 배포가 해당 버전을 유지합니다.

버전을 변경하면 실행 중인 복제본이 재시작됩니다. CUDA 13 배포는 버전 번호를 지정해야 합니다. 배포 생성 시 버전을 선택하려면 다음을 참조하세요. [전용 배포 만들기](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/create-a-dedicated-deployment.md).

### 환경 변수

일부  [추론 서버 환경 변수](https://docs.roboflow.com/deployment/ko/self-hosted/inference-server/configuration/environment-variables.md) 를 배포에 설정할 수 있습니다(예: `MAX_CONCURRENT_INFERENCE_REQUESTS`, `CONCURRENT_INFERENCE_REQUESTS_QUEUE_TIMEOUT`). 배포를 만들 때 "환경 변수"에서 설정하거나, 프로비저닝이 완료된 후 배포 설정에서 지정하세요. 기본값을 사용하려면 필드를 비워 두세요. 새 값을 저장하면 실행 중인 복제본이 재시작되며, 일시 중지된 배포는 재개될 때 새 값을 사용합니다.

### 알림 중지

전용 배포가 서비스를 중지하면 Roboflow는 워크스페이스 관리자와 배포를 만든 사용자에게 이메일을 보냅니다. 단, 비활성으로 인한 일시 중지, 만료 및 삭제는 제외됩니다. 사용할 수 있는 워크스페이스에서는 [시작 스크립트](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/startup-scripts.md)를 사용해 배포를 만들거나 수정할 때 "배포 알림 수신자"를 설정하세요. 선택한 멤버만 알림을 받으며, 목록이 비어 있으면 배포를 만든 사용자에게 알림이 전송됩니다. 수신자는 여전히 워크스페이스 멤버여야 합니다.

### **현재 제한 사항**

* 현재 모든 전용 배포는 미국에 있는 데이터 센터에서 호스팅되므로 다른 지역의 사용자는 지연 시간이 더 길 수 있습니다. 미국 외 지역에 계시다면 맞춤형 솔루션을 위해 문의해 주세요. 네트워크 지연 시간을 줄이는 데 도움을 드릴 수 있습니다.
* 전용 배포는 Core 및 Enterprise 요금제 워크스페이스에서 사용할 수 있습니다. 자세한 내용은 [Roboflow 요금제](https://roboflow.com/pricing).

### 전용 배포 유형

Roboflow는 dev-cpu, dev-gpu, prod-cpu, prod-gpu의 네 가지 전용 배포 유형을 제공합니다. dev-cpu와 dev-gpu는 개발 및 테스트용으로 설계되어 몇 시간 후 자동 삭제되는 반면, prod-cpu와 prod-gpu는 지속적으로 유지되며 대규모 프로덕션 트래픽을 처리하는 데 적합합니다.

<table data-search="false"><thead><tr><th width="184">유형</th><th>기능</th></tr></thead><tbody><tr><td>dev-cpu</td><td><p><strong>임시</strong>: 3시간 후 자동으로 삭제됩니다</p><p><strong>CPU</strong>: CPU에서 모델 추론을 실행할 수 있습니다</p><p>적합한 용도: <strong>통합 테스트</strong> 및 <strong>프로토타입</strong> 애플리케이션 개발</p></td></tr><tr><td>dev-gpu</td><td><p><strong>임시</strong>: 3시간 후 자동으로 삭제됩니다</p><p><strong>통합 테스트에 적합</strong> 및 <strong>프로토타입</strong> 애플리케이션 개발</p><p><strong>GPU</strong>: Florence 2와 같이 GPU 가속이 필요한 모델</p><p>적합한 용도: <strong>통합 테스트</strong> 및 <strong>프로토타입</strong> 애플리케이션 개발</p></td></tr><tr><td>prod-cpu</td><td><p><strong>지속형</strong>: 전용 하위 도메인 <code>&#x3C;some-name>.roboflow.cloud</code></p><p><strong>CPU</strong>: CPU에서 모델 추론을 실행할 수 있습니다</p><p>적합한 용도: <strong>프로덕션 트래픽 처리</strong></p></td></tr><tr><td>prod-gpu</td><td><p><strong>지속형</strong>: 전용 하위 도메인 <code>&#x3C;some-name>.roboflow.cloud</code></p><p><strong>GPU</strong>: Florence 2와 같이 GPU 가속이 필요한 모델</p><p>적합한 용도: <strong>프로덕션 트래픽 처리</strong></p></td></tr></tbody></table>

### **요금 정보**

전용 배포는 시간 단위로, 1분 간격으로 요금이 청구됩니다. GPU 배포(dev-gpu, prod-gpu)는 CPU 배포(dev-cpu, prod-cpu)보다 시간당 요금이 높습니다. 요금은 [크레딧 페이지](https://roboflow.com/credits) 에서 확인하세요.

전용 배포 서버로 전송된 요청 수를 기준으로 요금이 청구되기를 원하시면 [여기를 클릭해 영업팀에 문의하세요](https://roboflow.com/sales).

모든 전용 배포 서버는 오픈 소스 추론 서버인 [Roboflow Inference](https://docs.roboflow.com/deployment/ko/self-hosted/self-hosted.md)를 실행합니다. 사용 가능한 모든 기능에 대한 자세한 내용은 [Roboflow Inference 문서](https://docs.roboflow.com/deployment/ko/self-hosted/self-hosted.md) 를 참조하세요.

### 유용한 링크 <a href="#provision-and-manage-dedicated-deployments-web-application" id="provision-and-manage-dedicated-deployments-web-application"></a>

* [전용 배포를 만드는 방법(Roboflow 앱)](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/create-a-dedicated-deployment.md)
* [전용 배포를 만드는 방법(Roboflow CLI)](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/create-a-dedicated-deployment.md#create-a-dedicated-deployment-with-the-cli)
* [전용 배포 사용 방법](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/make-requests-to-a-dedicated-deployment.md)
* [HTTP API](#http-api)

## HTTP API

전용 배포는 다음 주소의 자체 서비스에서 관리됩니다. `https://roboflow.cloud`플랫폼 API인 `https://api.roboflow.com`에서 관리되지 않습니다. 이 엔드포인트를 사용해 배포를 생성, 확인, 일시 중지, 재개 및 삭제하고 로그와 사용량을 조회하세요. 배포가 준비된 후 모델을 실행하는 방법은 다음을 참조하세요. [전용 배포에 요청 보내기](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/make-requests-to-a-dedicated-deployment.md).

{% hint style="info" %}
[Deployment Manager](https://docs.roboflow.com/deployment/ko/self-hosted/enterprise/deployment-manager.md#http-api) 는 별개의 제품입니다. 전용 배포는 Roboflow 클라우드의 서버입니다. Deployment Manager 장치는 다음을 실행하는 자체 하드웨어입니다. [Roboflow Inference](https://docs.roboflow.com/deployment/ko/self-hosted/self-hosted.md).
{% endhint %}

GET 요청에서는 워크스페이스 API 키를 다음 위치에 전달합니다. `api_key` 쿼리 매개변수로 전달합니다. POST 요청에서는 API 키를 JSON 본문의 `api_key` 필드에 전달합니다. 성공 `200` 응답에는 JSON 본문이 있습니다. 그 외 상태 코드에서는 오류 메시지가 반환되며, 대개 일반 텍스트 형식입니다. 따라서 본문을 파싱하기 전에 상태 코드를 확인하세요.

### 머신 유형 나열

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/machine\_types" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 생성

배포는 백그라운드에서 시작되므로 응답의 `status` 는 `pending`으로 설정됩니다. 다음을 호출하세요. [배포 가져오기](#get-a-deployment) 30초마다 호출해 `status` 가 `ready`가 될 때까지 확인한 다음, 배포의 `domain`.

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/add" method="post" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 가져오기

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/get" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 나열

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/list" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 로그 가져오기

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/get\_log" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 워크스페이스 사용량 가져오기

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/usage\_workspace" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 사용량 가져오기

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/usage\_deployment" method="get" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 일시 중지

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/pause" method="post" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 재개

일시 중지된 배포에 API 키를 사용한 요청을 보내도 배포가 재개됩니다. 시작 스크립트 [실패](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/startup-scripts.md#failures) 후 일시 중지된 배포는 이 엔드포인트나 웹 앱을 통해서만 재개할 수 있습니다.

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/resume" method="post" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 배포 삭제

{% openapi src="/files/5c9caec11080d8ae7afaf066d166a9b9f093e6eb" path="/delete" method="post" %}
[dedicated-deployments.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-486a5780b2b1a819266e063e8747371b4d46a4d3%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}

### 시작 스크립트 업데이트

기존 배포의 시작 스크립트를 변경하는 방법은 다음을 참조하세요. [시작 스크립트](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments/startup-scripts.md#http-api).

## Python SDK

[전용 배포](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments.md) 는 예측 가능한 지연 시간과 높은 처리량으로 Roboflow 모델을 실행하는 관리형 GPU 머신입니다. SDK는 `roboflow.adapters.deploymentapi` 어댑터를 통해 이를 관리합니다. 상위 수준의 `Workspace` 클래스에는 현재 배포 관련 메서드가 제공되지 않습니다.

각 함수는 다음을 반환합니다. `(status_code, body)` HTTP 결과에 따라 분기할 수 있는 튜플입니다.

```python
from roboflow.adapters import deploymentapi

status, body = deploymentapi.list_deployment("YOUR_API_KEY")
if status == 200:
    for d in body:
        print(d["deployment_name"], d["status"])
else:
    print("Failed:", body)
```

### 사용 가능한 머신 유형 나열

```python
from roboflow.adapters import deploymentapi

status, body = deploymentapi.list_machine_types("YOUR_API_KEY")
for m in body.get("machine_types", []):
    print(m["name"], m.get("description"))
```

### 배포 생성

```python
status, body = deploymentapi.add_deployment(
    api_key="YOUR_API_KEY",
    creator_email="me@company.com",          # must be a workspace member
    machine_type="dev-gpu",
    duration=8,                                # hours
    delete_on_expiration=True,
    deployment_name="my-deployment",
    inference_version=None,                    # None → latest
)
```

배포는 비동기적으로 프로비저닝됩니다. 다음을 폴링하세요: `get_deployment` 다음이 될 때까지 `status == "ready"`.

### 배포 세부 정보 가져오기

```python
status, body = deploymentapi.get_deployment("YOUR_API_KEY", "my-deployment")
print(body["status"], body["domain"])
```

### 일시 중지 / 재개 / 삭제

```python
deploymentapi.pause_deployment("YOUR_API_KEY", "my-deployment")
deploymentapi.resume_deployment("YOUR_API_KEY", "my-deployment")
deploymentapi.delete_deployment("YOUR_API_KEY", "my-deployment")
```

### 로그

```python
import datetime as dt

status, body = deploymentapi.get_deployment_log(
    api_key="YOUR_API_KEY",
    deployment_name="my-deployment",
    from_timestamp=dt.datetime.utcnow() - dt.timedelta(hours=1),
    to_timestamp=dt.datetime.utcnow(),
    max_entries=200,
)
for entry in body:
    print(entry["timestamp"], entry["payload"])
```

### 사용량

```python
status, ws_usage = deploymentapi.get_workspace_usage(
    api_key="YOUR_API_KEY",
    from_timestamp=dt.datetime(2026, 4, 1),
    to_timestamp=dt.datetime(2026, 5, 1),
)

status, dep_usage = deploymentapi.get_deployment_usage(
    api_key="YOUR_API_KEY",
    deployment_name="my-deployment",
    from_timestamp=dt.datetime(2026, 4, 1),
    to_timestamp=dt.datetime(2026, 5, 1),
)
```

### 전용 배포에서 추론 실행

배포가 준비되면 추론 SDK 호출이 해당 배포의 `domain` (다음에서 반환됨: `get_deployment`):

```python
from inference_sdk import InferenceHTTPClient, InferenceConfiguration

client = InferenceHTTPClient(
    api_url=f"https://{body['domain']}", api_key="YOUR_API_KEY"
).configure(InferenceConfiguration(api_key_transport="header"))
result = client.infer("photo.jpg", model_id="my-detector/3")
```

## CLI

명령줄에서 [전용 배포를](https://docs.roboflow.com/deployment/ko/roboflow-cloud/dedicated-deployments.md) 생성, 모니터링, 관리할 수 있습니다.

### 배포 나열

```bash
roboflow deployment list
```

### 머신 유형 나열

```bash
roboflow deployment machine-type
```

### 배포 생성

```bash
roboflow deployment create <name> -m <machine-type> -e <email>
```

#### 옵션

| 플래그                         | 설명                                                             |
| --------------------------- | -------------------------------------------------------------- |
| `-m`, `--machine-type`      | 머신 유형(필수). 사용 가능한 옵션을 확인하려면 `deployment machine-type` 를 실행하세요. |
| `-e`, `--email`             | 이메일 주소. 워크스페이스 멤버여야 합니다(필수).                                   |
| `--duration`                | 기간(시간, 기본값: 3)                                                 |
| `--inference-version`       | 추론 서버 버전(기본값: latest)                                          |
| `--no-delete-on-expiration` | 만료되어도 배포 유지                                                    |
| `--wait`                    | 배포가 준비될 때까지 대기                                                 |

예시:

```bash
roboflow deployment create my-deployment -m dev-gpu -e me@company.com --duration 8
```

### 배포 세부 정보 확인

```bash
roboflow deployment get <name>
```

대기 중인 배포가 준비될 때까지 기다리기:

```bash
roboflow deployment get my-deployment --wait
```

### 로그 보기

```bash
roboflow deployment log <name>
```

실시간으로 로그 추적:

```bash
roboflow deployment log my-deployment -f
```

#### 옵션

| 플래그                | 설명                            |
| ------------------ | ----------------------------- |
| `-d`, `--duration` | 로그 조회 시간 범위(초, 기본값: 3600)     |
| `-n`, `--tail`     | 끝에서부터 표시할 줄 수(최대 50, 기본값: 10) |
| `-f`, `--follow`   | 로그 출력을 계속 추적                  |

### 사용량 통계

워크스페이스 전체 사용량을 확인합니다:

```bash
roboflow deployment usage
```

특정 배포의 사용량을 확인합니다:

```bash
roboflow deployment usage my-deployment
```

#### 옵션

| 플래그      | 설명              |
| -------- | --------------- |
| `--from` | 시작 시간(ISO 8601) |
| `--to`   | 종료 시간(ISO 8601) |

### 일시 중지, 재개 및 삭제

```bash
roboflow deployment pause my-deployment
roboflow deployment resume my-deployment
roboflow deployment delete my-deployment
```

### JSON 출력

모든 배포 명령은 다음 옵션을 지원합니다. `--json`:

```bash
roboflow deployment list --json
roboflow deployment get my-deployment --json
```
