도어 감지 API 문서

처리 시간 (무료 플랜)

도어 감지(POST /v1/drawings/detection/doors) 기능에만 적용됩니다.

무료 플랜에서는 작업당 보통 2~4분 정도 걸립니다. 처리 시간은 주로 페이지 수와 도면의 복잡도에 따라 달라지는데요. 여러 페이지의 복잡한 도면은 단일 시트보다 당연히 더 오래 걸립니다.

더 빠른 처리가 필요하신가요? Pro와 Enterprise 플랜은 전용 GPU 인프라에서 감지를 실행합니다.

POST /v1/drawings/detection/doors

건축 평면도 PDF에서 도어를 감지합니다. 이전에 업로드한 document_id를 받아서 inference 작업을 등록하고, 결과를 폴링할 수 있는 작업 객체를 반환합니다. 감지된 도어는 PDF 좌표계 기준으로 바운딩 박스로 표현됩니다.

특징

• 비동기 처리
• 페이지당 2,022 크레딧 소비

요청

X-API-Key 헤더로 인증하고, 본문은 JSON 형식입니다. 이 엔드포인트는 파일을 직접 업로드하지 않습니다.

먼저 PDF를 업로드해야 document_id를 받을 수 있습니다.

요청 파라미터

주의사항

크레딧은 제출할 때 len(page_numbers) (또는 생략 시 문서의 전체 페이지 수)를 기준으로 청구됩니다. 실제로 도어가 있는 페이지 수와 무관합니다. 과금을 피하려면 유효한 페이지 번호만 전송하세요.

코드 예제

curl -X POST https://api.anchorgrid.ai/v1/drawings/detection/doors \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"document_id": "550e8400-e29b-41d4-a716-446655440000",
"page_numbers": [1, 2, 3]
}'

응답 (202 Accepted)

작업이 즉시 등록됩니다. GET /v1/jobs/{job_id}를 폴링해서 상태가 complete 또는 failed가 될 때까지 기다립니다.

{
  "job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "queued",
  "poll_url": "/v1/jobs/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

결과 형식

상태가 complete이고 model이 "door-detector"일 때, job 객체의 result 필드에 다음이 포함됩니다.

참고

doors 목록은 반환하기 전에 기하학 및 중앙값 영역 파이프라인으로 후처리됩니다. doors_found는 항상 필터링된 수를 반영하며, 필터링 전 수는 노출되지 않습니다.

크레딧 & 속도 제한

비용

• 페이지당 2 크레딧

속도 제한

무료 플랜은 평생 크레딧 한도가 있고, 초과하면 402 FREE_TIER_LIMIT_REACHED를 반환합니다.

Developer / Pro는 월간 크레딧 풀을 가지며, 초과하면 429 QUOTA_EXCEEDED를 반환합니다.

Enterprise는 할당량 체크가 없습니다.

429 응답에는 retry_after_seconds 값이 본문에 포함됩니다. 할당량 초과와 속도 제한 초과는 모두 동일한 상태 코드를 반환하므로, 에러 본문을 확인해서 구분하세요.

에러