EDI 제약사 분류 / 이미지라벨링

처방전·EDI 사진 한 장이면 어느 제약사 약인지 색깔로 표시해 드립니다. 여러 제약사 약이 섞여 있어도 한눈에 구분되고, 제약사별로 일일이 나눠 정리하던 수작업이 사라집니다.

바로 실행

이미지를 올려 바로 실행해 결과를 확인하세요. (비로그인은 하루 실행 횟수 제한)

엔드포인트

POST https://marketapi.nadoo.ai/api/v1/hira-detect/detect

인증

요청

요청 헤더

요청 본문 — (A) 바이너리

Content-Type: image/jpeg(또는 png)로 이미지 바이트를 그대로 전송합니다. (최대 25MB)

요청 본문 — (B) JSON

쿼리 파라미터 (선택)

응답 200 OK

응답 예시

{
  "requestId": "3f9a1c2e-...",
  "items": [
    { "code": "658107190", "manufacturer": "한풍제약 주식회사",
      "drugName": "아제나정(아젤라스틴염산염)", "found": true,
      "box": { "x": 198, "y": 689, "width": 101, "height": 24 } }
  ],
  "uniqueManufacturers": ["한풍제약 주식회사"],
  "width": 1600, "height": 881,
  "tagged": false,
  "rotation": 90,
  "unknownCodes": [],
  "original": { "mode": "gcs", "contentType": "image/jpeg",
    "url": "https://storage.googleapis.com/cso-ai-results/original/...?X-..." },
  "labeled": null,
  "output": { "mode": "gcs", "url": "https://.../original/...?X-..." },
  "cost": { "krw": 300, "free": false },
  "balanceKrw": 49800
}

위 예시는 단일 제약사 + 옵션 없음 — 기존 스펙대로 labeled: null, tagged: false 이고 output은 원본입니다. ?labelSingle=1을 붙이면 labeled가 합성되고 output이 라벨본, tagged: true가 됩니다.

에러 응답

본문: { "error": "<code>", ... }

// 402 예시
{ "error": "insufficient_credit", "freeUsed": 10, "freeQuota": 10,
  "applyUrl": "https://market.nadoo.ai/dashboard/apply" }

예시 (cURL)

curl -X POST https://marketapi.nadoo.ai/api/v1/hira-detect/detect \
  -H "x-api-key: pk_live_xxxxxxxx" \
  -H "Content-Type: image/jpeg" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @처방전.jpg

벌크 (다중 이미지)

여러 이미지를 한 요청으로 처리합니다(최대 50건, 제한 동시성). 항목별로 독립 과금되며(성공 300원/건, 실패 시 자동 환불), 부분 성공을 지원합니다. 대량은 imageUrls 사용을 권장합니다(요청 본문 25MB 제한).

요청 본문 (JSON)

응답 200 OK

예시 (cURL)

curl -X POST https://marketapi.nadoo.ai/api/v1/hira-detect/detect-batch \
  -H "x-api-key: pk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"imageUrls":["https://.../a.jpg","https://.../b.jpg"]}'

대용량 업로드 (presigned, 권장)

base64는 요청 크기 한계(본문 25MB·원본 ~18MB)가 있어, 대용량·대량은 presigned 업로드가 안정적입니다(용량 무제한 — 이미지를 GCS로 직접 PUT). ① 업로드 URL 발급 → ② 이미지 PUT → ③ imageUrl 로 검출.

# ① 업로드 URL 발급
curl -X POST https://marketapi.nadoo.ai/api/v1/uploads \
  -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"contentType":"image/jpeg"}'
# → { "uploadUrl": "https://storage.googleapis.com/...(서명)", "imageUrl": "https://.../key", "expiresIn": 900 }

# ② 이미지를 uploadUrl 로 PUT (같은 Content-Type)
curl -X PUT "<uploadUrl>" -H "Content-Type: image/jpeg" --data-binary @처방전.jpg

# ③ imageUrl 로 검출(단건·배치 공통)
curl -X POST https://marketapi.nadoo.ai/api/v1/hira-detect/detect -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"imageUrl":"<imageUrl>"}'

비동기 대량

대량용(최대 500장). 접수 즉시 202로 jobId·pollUrl을 반환하고, 처리는 백그라운드(큐)에서 진행됩니다. 본문은 detect-batch와 동일(images/imageUrls — 대량은 presigned imageUrls 권장).

curl -X POST https://marketapi.nadoo.ai/api/v1/hira-detect/detect-batch-async \
  -H "x-api-key: pk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"imageUrls":["https://.../a.jpg","https://.../b.jpg"]}'
# → { "jobId": "job_abc", "status": "queued", "total": 2, "pollUrl": "/api/v1/jobs/job_abc" }

작업 폴링 GET /api/v1/jobs/{jobId}

작업 진행 상태·결과를 조회합니다(본인 소유만). status가 종료 상태 (done 전건 성공 / partial 일부 실패 / failed 전건 실패)가 될 때까지 폴링하세요. 응답은 jobId·status·total·done·ok·failed·totalCostKrw·balanceKrw와 results[](항목별 index·status + 단건 검출 필드 items·uniqueManufacturers·output 등)를 포함합니다.

curl https://marketapi.nadoo.ai/api/v1/jobs/job_abc -H "x-api-key: pk_live_xxxxxxxx"
# → { "jobId": "job_abc", "status": "done", "total": 2, "done": 2, "ok": 2, "failed": 0,
#     "results": [ { "index": 0, "status": "ok",
#       "items": [{ "code": "658107190", "manufacturer": "한풍제약 주식회사", "box": {...} }],
#       "uniqueManufacturers": ["한풍제약 주식회사"], "output": { "mode": "gcs", "url": "https://..." } }, ... ] }

시작하기 (키 발급)