> 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/legacy/legacy-serverless.md).

# 호스팅 API(레거시)

{% hint style="info" %}
우리는 **권장합니다** 현재의 [Serverless Cloud API](/deployment/ko/roboflow-cloud/serverless-api.md), 더 빠릅니다.\
\
[새 API를 시작하려면 Serverless Cloud API 문서를 참조하세요.](/deployment/ko/roboflow-cloud/serverless-api.md)
{% endhint %}

## 모델 지원

{% hint style="warning" %}
Florence-2, SAM 3 등과 같은 최신 모델 아키텍처는 현재 Serverless Cloud API에서만 사용할 수 있습니다. 크레딧 기반 요금제로 마이그레이션하지 않은 기존 작업 공간에서는 이러한 모델을 사용하려고 할 때 `402` 오류가 발생합니다. [요금제를 업그레이드하여](https://docs.roboflow.com/platform/billing-and-plans/plans/purchase-a-plan) 다음을 통해 지원되는 전체 모델 집합에 액세스하세요 [Serverless Cloud API](/deployment/ko/roboflow-cloud/serverless-api.md).
{% endhint %}

다음 모델 유형은 Hosted API(레거시)에서 지원됩니다:

| 작업 유형                                                                                            | Hosted API(레거시)에서 지원됨 |
| ------------------------------------------------------------------------------------------------ | --------------------- |
| [객체 탐지](/deployment/ko/legacy/legacy-serverless/object-detection.md)                             | ✅                     |
| [분류](/deployment/ko/legacy/legacy-serverless/classification.md)                                  | ✅                     |
| [인스턴스 분할](/deployment/ko/legacy/legacy-serverless/instance-segmentation.md)                      | ✅                     |
| [시맨틱 분할](/deployment/ko/legacy/legacy-serverless/instance-segmentation/semantic-segmentation.md) | ✅                     |
| [키포인트 탐지](/deployment/ko/legacy/legacy-serverless/keypoint-detection.md)                         | ✅                     |

## 지연 시간 비교

Hosted API(레거시)로 전송된 요청의 엔드투엔드 지연 시간은 여러 요인에 따라 달라집니다:

1. 모델 아키텍처, 이는 실행 시간에 영향을 줍니다
2. 업로드 시간과 실행 중 모델 추론 시간에 영향을 미치는 이미지의 크기와 해상도
3. 요청 업로드 시간과 응답 다운로드 시간에 영향을 미치는 네트워크 지연 시간과 대역폭.
4. 특정 시점의 서비스 구독 상태와 다른 사용자의 사용량으로 인해 대기열 지연이 발생할 수 있음

<figure><img src="/files/de223ab732bd30239f5a295ca4f51db46fd191d1" alt=""><figcaption></figcaption></figure>

아래 표에서는 Hosted API(레거시)와 Serverless Cloud API의 대표적인 벤치마크를 보여줍니다. 여기에는 엔드투엔드 지연 시간(E2E)과 실행 시간(Exec) 모두가 표시됩니다. 이 수치는 참고용이며, 사용자께서는 다음을 사용하여 자체 벤치마크를 수행하시길 권장합니다 [저희 추론 벤치마크 도구](https://docs.roboflow.com/reference/inference/inference-cli/benchmark) 또는 자체 맞춤형 벤치마크를 사용하십시오.

<table data-search="false"><thead><tr><th width="176.14410400390625">모델</th><th>V2(엔드투엔드)</th><th>V2(실행)</th><th>V1(엔드투엔드)</th><th>V1(실행)</th></tr></thead><tbody><tr><td>yolov8x-640</td><td>401 ms</td><td>29 ms</td><td>4084 ms</td><td>821 ms</td></tr><tr><td>yolov8m-640</td><td>757 ms</td><td>21 ms</td><td>572 ms</td><td>265 ms</td></tr><tr><td>yolov8n-640</td><td>384 ms</td><td>17 ms</td><td>312 ms</td><td>63 ms</td></tr><tr><td>yolov8x-1280</td><td>483 ms</td><td>97 ms</td><td>6431 ms</td><td>3032 ms</td></tr><tr><td>yolov8m-1280</td><td>416 ms</td><td>52 ms</td><td>1841 ms</td><td>1006 ms</td></tr><tr><td>yolov8n-1280</td><td>428 ms</td><td>35 ms</td><td>464 ms</td><td>157 ms</td></tr></tbody></table>

사용자께서는 특정 사용 사례에 대한 실제 지표를 얻기 위해 모델 추론과 워크플로우에 대해 자체 벤치마크를 실행하시길 권장합니다.

## 제한 사항

Hosted API(레거시)는 특정 작업 유형과 관계없이 최대 5MB의 파일을 허용합니다. 이 제한에는 이미지 파일 크기와 첨부된 요청 정보가 포함되며 이에 국한되지 않습니다.

{% hint style="info" %}
요청이 너무 큰 경우, 첨부된 이미지를 축소하는 것을 권장합니다. 이미지는 서버에서 수신된 후 모델 아키텍처가 허용하는 입력 크기로 어차피 축소되므로, 일반적으로 성능 저하가 발생하지 않습니다.\
\
Python SDK와 같은 일부 SDK는 API로 전송되기 전에 이미지를 모델 아키텍처의 입력 크기로 자동 축소합니다.
{% endhint %}