> 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/roboflow/roboflow-ko/deploy/serverless.md).
# (레거시) Serverless Hosted API
{% hint style="info" %}
저희는 **권장합니다** Serverless Hosted API의 V2를 사용하는 것을. V2 API가 더 빠릅니다.\
\
[새로운 API를 시작하려면 Serverless Hosted API V2 문서를 참조하세요.](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2.md)
{% endhint %}
## 모델 지원
{% hint style="warning" %}
Florence-2, SAM 3 및 기타와 같은 최신 모델 아키텍처는 Serverless Hosted API V2에서만 사용할 수 있습니다. 크레딧 기반 플랜으로 이전하지 않은 레거시 Workspaces는 `402` 이 모델을 사용하려고 할 때 오류가 발생합니다. [플랜을 업그레이드하여](/roboflow/roboflow-ko/billing/plans/purchase-a-plan.md) 다음을 통해 지원되는 전체 모델 세트에 액세스하세요. [Serverless Hosted API V2](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2.md).
{% endhint %}
다음 모델 유형은 Serverless Hosted API(v1)에서 지원됩니다:
| 작업 유형 | Hosted API(v1)에서 지원됨 |
| ------------------------------------------------------------------------------------------------ | -------------------- |
| [객체 감지](/roboflow/roboflow-ko/deploy/serverless/object-detection.md) | ✅ |
| [분류](/roboflow/roboflow-ko/deploy/serverless/classification.md) | ✅ |
| [인스턴스 분할](/roboflow/roboflow-ko/deploy/serverless/instance-segmentation.md) | ✅ |
| [시맨틱 분할](/roboflow/roboflow-ko/deploy/serverless/instance-segmentation/semantic-segmentation.md) | ✅ |
| [키포인트 감지](/roboflow/roboflow-ko/deploy/serverless/keypoint-detection.md) | ✅ |
## 지연 시간 비교(v1 vs v2)
Serverless Hosted API로 전송된 요청의 엔드투엔드 지연 시간은 여러 요인에 따라 달라집니다:
1. 실행 시간에 영향을 미치는 모델 아키텍처
2. 업로드 시간과 실행 중 모델 추론 시간에 영향을 미치는 이미지의 크기와 해상도
3. 요청 업로드 시간과 응답 다운로드 시간에 영향을 미치는 네트워크 지연 시간 및 대역폭.
4. 특정 시점의 서비스 구독 및 다른 사용자의 사용량으로 인해 대기열 지연 시간이 발생할 수 있습니다
아래 표에는 v1과 v2 Serverless Hosted API의 대표적인 벤치마크 일부를 보여드립니다. 여기에는 엔드투엔드 지연 시간(E2E)과 실행 시간(Exec) 모두가 포함됩니다. 이 수치는 참고용이며, 사용자가 다음을 사용해 직접 벤치마크를 수행하는 것을 권장합니다. [저희의 추론 벤치마크 도구](https://inference.roboflow.com/inference_helpers/cli_commands/benchmark/) 또는 사용자의 자체 커스텀 벤치마크.
모델
V2(E2E)
V2(Exec)
V1(E2E)
V1(Exec)
yolov8x-640
401 ms
29 ms
4084 ms
821 ms
yolov8m-640
757 ms
21 ms
572 ms
265 ms
yolov8n-640
384 ms
17 ms
312 ms
63 ms
yolov8x-1280
483 ms
97 ms
6431 ms
3032 ms
yolov8m-1280
416 ms
52 ms
1841 ms
1006 ms
yolov8n-1280
428 ms
35 ms
464 ms
157 ms
사용자가 자신의 모델 추론과 워크플로에 대해 자체 벤치마크를 실행하여 특정 사용 사례에 대한 실제 지표를 얻는 것을 권장합니다.
## 제한 사항
Serverless Hosted API(v1)는 특정 작업 유형과 관계없이 최대 5MB까지의 파일을 허용합니다. 이 제한에는 이미지 파일 크기와 첨부된 모든 요청 정보가 포함되지만 이에 국한되지는 않습니다.
{% hint style="info" %}
요청이 너무 큰 경우, 첨부된 이미지를 축소하는 것을 권장합니다. 이미지가 서버에서 수신된 후 모델 아키텍처가 허용하는 입력 크기로 다시 축소되므로, 이는 일반적으로 성능 저하로 이어지지 않습니다.\
\
Python SDK와 같은 일부 SDK는 API로 전송되기 전에 이미지를 모델 아키텍처의 입력 크기로 자동 축소합니다.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.roboflow.com/roboflow/roboflow-ko/deploy/serverless.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.