> 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-hosted-api-v2.md).

# Serverless Hosted API

Roboflow에 배포된 모델에는 이미지를 대상으로 추론을 실행할 수 있는 REST API가 제공됩니다. 이 배포 방식은 배포 장치에 지속적인 인터넷 연결이 있는 환경에 이상적입니다.

Serverless Hosted API를 사용할 수 있습니다:

* [Workflows에서](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2/use-in-a-workflow.md)
* [REST API와 함께](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2/use-with-the-rest-api.md)
* 과 함께 [Inference Python SDK](/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2/use-with-python-sdk.md)

### Inference server

우리의 Serverless Hosted API는 다음을 기반으로 합니다: [Inference Server](https://inference.roboflow.com/api/). 즉, 아래와 같이 우리의 Serverless Hosted API와 자체 호스팅 옵션 사이를 쉽게 전환할 수 있으며, 그 반대로도 가능합니다:

```python
from inference_sdk import InferenceHTTPClient

CLIENT = InferenceHTTPClient(
    # api_url="http://localhost:9001" # 자체 호스팅 Inference server
    api_url="https://serverless.roboflow.com", # 우리의 Serverless hosted API
    api_key="API_KEY" # 비공개 모델과 데이터에 접근하기 위한 선택 사항
)

result = CLIENT.infer("image.jpg", model_id="model-id/1")
print(result)
```

### 제한 사항

우리의 Serverless Hosted API는 최대 20MB의 파일 업로드를 지원합니다. 더 높은 해상도의 이미지에서는 제한에 걸릴 수 있습니다. 문제가 발생하면 엔터프라이즈 지원 담당자에게 문의하거나 다음에 메시지를 게시해 주세요: [포럼](https://discuss.roboflow.com).

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

***

이것은 우리의 Serverless Hosted API의 V2입니다. 다음을 참조하세요: [Serverless Hosted API v1](/roboflow/roboflow-ko/deploy/serverless.md) v1(레거시) API 문서를 위해.


---

# 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:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/deploy/serverless-hosted-api-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.