> 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/reference/ko/inference/inference-server-openapi.md).

# Inference Server OpenAPI

기계 판독 가능한 OpenAPI 사양이 포함된 자가 호스팅 Roboflow Inference Server용 HTTP API를 둘러보고 테스트하세요.

실행 중인 [추론 서버](https://docs.roboflow.com/deployment/self-hosted/inference-server) 현재 실행 중인 서버 버전에 일치하는 OpenAPI 사양을 게시합니다.

아래 작업은 최신 Inference 릴리스에서 가져온 것입니다. 또한 [해당 OpenAPI 사양을 다운로드할 수 있습니다](https://github.com/roboflow/docs/tree/main/reference/.gitbook/assets/inference-server.json).

서버를 시작한 다음 브라우저에서 해당 API 참조를 여세요:

```bash
pip install inference-cli
inference server start
```

<table data-search="false"><thead><tr><th>엔드포인트</th><th>제공하는 항목</th></tr></thead><tbody><tr><td><code>http://localhost:9001/docs</code></td><td>대화형 요청 빌더가 포함된 Swagger UI입니다.</td></tr><tr><td><code>http://localhost:9001/redoc</code></td><td>동일한 사양에 대한 ReDoc 참조입니다.</td></tr></tbody></table>

아래 API 참조는 `http://localhost:9001`을 사용합니다. 이는 로컬 Inference Server의 기본 주소입니다. 이 기본 URL을 호출하려는 서버의 주소로 바꾸세요:

* 다음을 사용하세요 `https://serverless.roboflow.com` 용 [서버리스 호스팅 API](https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api).
* 다음에 할당된 URL을 사용하세요 [전용 배포](https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments).
* 다른 자체 호스팅 Inference Server의 IP 주소 또는 호스트명과 포트를 사용하세요.

{% hint style="info" %}
이 API는 모델과 워크플로를 실행하기 위한 것입니다. 작업공간, 프로젝트, 버전, 학습을 위한 Roboflow Platform API는 다음을 참조하세요. [플랫폼 API OpenAPI 참조](https://docs.roboflow.com/reference/ko/platform/rest-api/platform-api-openapi.md).
{% endhint %}

## 서버

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/healthz" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/readiness" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/info" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/metrics" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/logs" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/dashboard.html" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/dashboard.html" method="head" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/model/registry" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

## 핵심 추론

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/{dataset\_id}/{version\_id}" method="get" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/{dataset\_id}/{version\_id}" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/infer/depth-estimation" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/infer/depth-estimation/{model\_id}" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/infer/lmm" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/infer/lmm/{model\_id}" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

## 임베딩과 비교

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/clip/compare" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/clip/embed\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/clip/embed\_text" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/perception\_encoder/compare" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/perception\_encoder/embed\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/perception\_encoder/embed\_text" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

## 세그멘테이션과 객체 탐지

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/grounding\_dino/infer" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/owlv2/infer" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/yolo\_world/infer" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam/embed\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam/segment\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam2/embed\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam2/segment\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam3/embed\_image" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam3/concept\_segment" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam3/visual\_segment" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/sam3\_3d/infer" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

## OCR

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/doctr/ocr" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/easy\_ocr/ocr" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/ocr/pp-ocr" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/ocr/trocr" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

## WebRTC

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/initialise\_webrtc\_worker" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/webrtc/session/heartbeat" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}

{% openapi src="/files/599bae814f9c948899cd6ca95cc0194e628b0163" path="/webrtc/session/heartbeat/end" method="post" %}
[inference-server.json](https://2939763035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-83e67fddbfefb900aec405e586c787c83f66a20c%2Finference-server.json?alt=media)
{% endopenapi %}
