> 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/get-started/ko/agents/api-specs.md).

# OpenAPI 사양

모든 Roboflow HTTP API에 대한 기계 판독 가능한 OpenAPI 사양과 AI 에이전트 및 코드 생성기가 이를 가져오는 방법.

Roboflow HTTP API는 모두 기계가 읽을 수 있는 OpenAPI 사양을 제공합니다. 이 사양을 사용하면 API를 대상으로 코드를 작성하거나 클라이언트를 생성할 수 있으며, AI 에이전트가 이 문서를 둘러보지 않고도 Roboflow를 호출하도록 할 수 있습니다. 이 사양은 각 페이지의 API 블록을 렌더링하는 데 사용되는 파일과 동일하므로 항상 문서와 일치합니다.

사양 파일을 확인하려면 페이지의 Markdown 버전을 엽니다. URL에 `.md` 를 추가하세요. 각 API 블록에는 해당 블록을 렌더링하는 사양 파일의 링크가 있습니다.

<table data-search="false"><thead><tr><th>API</th><th>페이지</th><th>서버</th><th>포함 항목</th></tr></thead><tbody><tr><td>플랫폼 API</td><td><a href="https://docs.roboflow.com/reference/platform/rest-api/platform-api-openapi">플랫폼 API OpenAPI</a></td><td><code>https://api.roboflow.com</code></td><td>워크스페이스, 프로젝트, 이미지, 버전, 학습, Workflows, Vision Events, Deployment Manager, API 키 및 기타 Roboflow 앱 기능.</td></tr><tr><td>Workflow 게시</td><td><a href="https://docs.roboflow.com/workflows/manage/manage-workflows#save-and-publish-a-version">버전 저장 및 게시</a></td><td><code>https://api.roboflow.com</code></td><td>저장된 버전, 게시, Eval 게이트 및 수동 승인 규칙을 위한 워크스페이스별 계약입니다.</td></tr><tr><td>일괄 처리</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing">일괄 처리</a></td><td><code>https://api.roboflow.com</code></td><td>데이터 스테이징 배치 및 배치 Workflow 작업.</td></tr><tr><td>서버리스 클라우드 API</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/serverless-api">서버리스 API</a></td><td><code>https://serverless.roboflow.com</code></td><td>Roboflow 클라우드에서 모델 및 Workflow 추론을 수행합니다.</td></tr><tr><td>Inference Server</td><td><a href="https://docs.roboflow.com/reference/inference/inference-server-openapi">Inference Server OpenAPI</a></td><td><code>http://localhost:9001</code></td><td>자체 호스팅 서버에서 모델 및 Workflow 추론을 수행합니다.</td></tr><tr><td>전용 배포</td><td><a href="https://docs.roboflow.com/deployment/roboflow-cloud/dedicated-deployments">전용 배포</a></td><td><code>https://roboflow.cloud</code></td><td>전용 배포를 생성하고 일시 중지하며 모니터링합니다.</td></tr><tr><td>Roboflow로 로그인</td><td><a href="https://docs.roboflow.com/reference/authentication/authentication/sign-in-with-roboflow-developer-reference">개발자 참조</a></td><td><code>https://app.roboflow.com</code></td><td>OAuth 토큰 교환, 갱신, 취소 및 사용자 정보.</td></tr><tr><td>장치 서비스</td><td><a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/event-store/rest-api">이벤트 저장소</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/plc-relay">PLC 릴레이</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/rtsp-simulator">RTSP 시뮬레이터</a>, <a href="https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/services/opc-ua-server">OPC UA 서버</a></td><td>장치의 IP 주소</td><td>Deployment Manager가 장치에서 실행하는 서비스의 API입니다.</td></tr></tbody></table>

## 에이전트 팁

* 플랫폼 API 사양은 크기가 큽니다(약 750KB). 전체를 불러오는 대신 경로나 `operationId` 를 검색하세요.
* 모든 문서 페이지는 Markdown으로도 제공됩니다. URL에 `.md` 를 추가하세요. [llms.txt](https://docs.roboflow.com/llms.txt) 파일에 모든 페이지가 나열되어 있습니다.
* API 키를 다음 형식으로 전송하세요: `Authorization: Bearer` 헤더 또는 `api_key` 쿼리 매개변수입니다. 자세한 내용은 [REST API 인증](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api).
* HTTP 호출을 직접 작성하는 대신 Workspace에서 작업하려면 다음을 연결하세요: [MCP 서버](https://docs.roboflow.com/get-started/ko/agents/mcp-server.md).
