Image to SVG

트레이싱 알고리즘을 사용해 래스터 이미지를 SVG로 벡터화합니다. 흑백 트레이싱(potrace)과 풀컬러 다중 레이어 벡터화를 지원합니다.

API Endpoint

POST /api/v1/tools/image/vectorize

Parameters

Parameter	Type	Required	Default	Description
colorMode	string	No	"bw"	트레이싱 모드: bw(흑백) 또는 color(다중 색상 레이어)
threshold	number	No	128	흑백 모드의 밝기 임계값 (0 ~ 255). 이 값 아래의 픽셀은 검정이 됩니다.
colorPrecision	number	No	6	컬러 모드의 색상 양자화 정밀도 (1 ~ 16). 값이 높을수록 더 뚜렷한 색상 레이어가 생성됩니다.
layerDifference	number	No	6	컬러 모드에서 레이어 간 최소 색상 차이 (1 ~ 128)
filterSpeckle	number	No	4	트레이싱된 도형의 최소 면적(픽셀) (1 ~ 256). 노이즈/얼룩을 제거합니다.
pathMode	string	No	"spline"	경로 스무딩: none(들쭉날쭉), polygon(직선 세그먼트), spline(부드러운 곡선)
cornerThreshold	number	No	60	컬러 모드의 모서리 감지 각도 임계값 (0 ~ 180도)
invert	boolean	No	false	트레이싱 전에 이미지 반전(흑백 교환)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "[email protected]" \
  -F 'settings={"colorMode":"bw","threshold":128,"filterSpeckle":4,"pathMode":"spline"}'

Color Vectorization

curl -X POST http://localhost:1349/api/v1/tools/image/vectorize \
  -F "[email protected]" \
  -F 'settings={"colorMode":"color","colorPrecision":8,"layerDifference":6,"filterSpeckle":4}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/logo.svg",
  "originalSize": 45678,
  "processedSize": 12345
}

Notes

• 입력 형식에 관계없이 출력은 항상 SVG 파일입니다.
• HEIC, RAW, PSD, SVG 입력 형식을 지원합니다(트레이싱 전에 자동으로 래스터로 디코딩됨).
• 흑백 모드는 potrace 알고리즘을 사용합니다. 이미지는 먼저 그레이스케일로 변환된 다음 트레이싱 전에 순수 흑백으로 임계값 처리됩니다.
• 컬러 모드는 다중 레이어 접근 방식을 사용합니다: 이미지가 색상 레이어로 양자화되고, 각 레이어가 개별적으로 트레이싱되어 SVG 출력에 쌓입니다.
• filterSpeckle 값이 낮을수록 더 많은 디테일을 보존하지만 경로가 더 많은 큰 SVG 파일이 생성됩니다.
• pathMode 설정은 파일 크기에 큰 영향을 미칩니다: none는 가장 많은 경로를, spline는 가장 부드러운(그리고 대개 가장 작은) 출력을 생성합니다.
• 로고와 아이콘에 최적의 결과를 얻으려면 깨끗한 고대비 입력으로 흑백 모드를 사용하세요. 사진이나 일러스트레이션에는 더 높은 colorPrecision와 함께 컬러 모드를 사용하세요.