이미지 수천 장,
비슷한 것끼리 자동으로 묶고 이름까지.

Image clustering API: send image URLs, get named clusters back as JSON.

이미지 URL 목록만 보내면 DINOv3로 비슷한 것끼리 묶고, 묶음마다 Claude가 이름과 설명을 붙여 JSON으로 돌려줍니다. 거의 같은 사진과 튀는 사진도 같이 찾아 줘요.

베타 API 키 신청 API 사용법

이럴 때 씁니다

라벨링 전에 분류수천 장을 사람이 하나씩 보기 전에 비슷한 것끼리 먼저 묶어 두면, 묶음 단위로 라벨을 달 수 있어요.

중복·유사 이미지 정리거의 같은 사진 묶음을 따로 알려 줘서 데이터셋이나 상품 이미지에서 중복을 걸러 냅니다.

불량·결함 사진 유형 파악공정 사진에서 어떤 종류가 얼마나 있는지, 어디에도 안 맞는 튀는 사진은 무엇인지 한 번에 봅니다.

어떻게 도나

이미지 URL 목록을 보냅니다. 공개 http(s) 주소, 한 번에 최대 10,000장.
서버리스 GPU가 DINOv3 ViT-L로 특징을 뽑고 묶습니다. 작업이 있을 때만 GPU가 켜집니다.
묶음마다 대표 사진 몇 장을 Claude가 보고 이름과 설명을 붙입니다. 결과는 JSON으로 7일간 받을 수 있어요.

결과 형식

아래 값은 형식을 보여 주는 예시입니다.

{
  "summary": {"images_ok": 1200, "clusters": 25, "near_duplicate_groups": 4, "outliers": 11},
  "clusters": [
    {"cluster_id": 0, "size": 212, "name": "붉은 산화 스케일",
     "description": "표면에 붉은 산화막이 넓게 덮인 강판 사진",
     "cohesion": 0.83, "representatives": [17, 402, 88, 951], "members": [3, 17, 25, ...]}
  ],
  "near_duplicates": [[12, 13, 870]],
  "outliers": [64, 1203],
  "failed": [{"index": 5, "error": "HTTPError: 404"}]
}

요금

베타 기간 무료

API 키 하나당 하루 10,000장 · 작업 10건까지. 더 필요하면 키 신청할 때 알려 주세요.

이미지와 개인정보

이미지는 저장하지 않고 메모리에서만 처리합니다. 결과는 7일 뒤 지워집니다. 다만 묶음 이름을 지을 때 묶음마다 대표 사진 몇 장을 작은 썸네일(긴 변 336px)로 줄여 Anthropic의 Claude API에 보냅니다. 원치 않으면 "name_clusters": false로 보내세요. 그러면 외부로 나가는 것이 없습니다. 사람의 신원을 알아내는 용도로는 쓸 수 없습니다.

API 사용법

모든 요청에 Authorization: Bearer <API 키> 헤더가 필요합니다.

curl -X POST "https://API주소/v1/jobs" \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"image_urls": ["https://example.com/a.jpg", "https://example.com/b.jpg"], "language": "ko"}'
# → 202 {"job_id": "fc-...", "status": "queued", "images": 2}

curl "https://API주소/v1/jobs/fc-..." -H "Authorization: Bearer $API_KEY"
# → 처리 중 202, 끝나면 200 + 결과 JSON

필드	기본값	설명
`image_urls`	(필수)	공개 http(s) 이미지 URL 목록. 결과의 번호는 이 목록의 순서(0부터)
`name_clusters`	`true`	Claude로 묶음 이름·설명 붙이기
`language`	`"ko"`	`"ko"` 또는 `"en"`
`dup_threshold`	`0.96`	이 코사인 유사도 이상이면 '거의 같은 이미지'