이미지 변환

POST /api/v1/images/conversions는 multipart/form-data를 받습니다. 필요한 범위: images:convert.

폼 필드

필드	타입	필수	기본값	규칙
`image`	file	예	—	PNG, JPEG, WebP. 최대 10 MiB, 디코딩 후 4,000만 픽셀까지
`format`	string	예	—	`svg`, `pptx`, `png`, `pdf`, `tiff`
`vector_mode`	string	아니요	`editable_text`	SVG 전용
`dpi`	string	아니요	`300`	`300`, `600`, `1000`. PNG, PDF, TIFF 전용

두 가지 SVG 모드

두 SVG 옵션 모두 구현되어 있으며 같은 엔드포인트로 제공됩니다:

`vector_mode`	결과	크레딧
`editable_text`	가능한 범위에서 텍스트를 편집할 수 있는 SVG	10
`full_vector`	완전히 벡터화된 SVG 출력	15

이 이름들은 출력의 성격을 설명합니다. 기능 라우팅은 SciDraw AI가 관리하며 공개 계약에 포함되지 않습니다.

다른 형식과 크레딧

형식	옵션	크레딧
`pptx`	—	10
`png`, `pdf`, `tiff`	`dpi=300`	5
`png`, `pdf`, `tiff`	`dpi=600`	10
`png`, `pdf`, `tiff`	`dpi=1000`	15

SVG가 아닌 형식에 full_vector를 보내거나 SVG·PPTX에 기본값이 아닌 DPI를 보내면 400 INVALID_REQUEST를 반환합니다.

cURL: 텍스트 편집 가능한 SVG

curl https://sci-draw.com/api/v1/images/conversions \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: figure-12-svg-editable' \
  -F 'image=@figure.png;type=image/png' \
  -F 'format=svg' \
  -F 'vector_mode=editable_text'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('format', 'svg');
form.set('vector_mode', 'full_vector');
const response = await fetch('https://sci-draw.com/api/v1/images/conversions', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/conversions",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"format": "svg", "vector_mode": "full_vector"},
    )

두 번째 SVG 기능을 쓰려면 vector_mode=full_vector를 지정하세요. 성공한 작업의 result.files[0]에 format, mime_type, 다운로드 URL이 담깁니다.

VSDX (Visio)

웹 앱에서는 다이어그램 이미지를 편집 가능한 Microsoft Visio(VSDX) 파일로 재구성할 수도 있습니다. 도형·연결선·텍스트가 이동 가능한 네이티브 개체가 됩니다. 이 기능은 이미지 변환 도구와 AI Drawing 에디터에서 사용할 수 있으며, 본 API로는 제공되지 않습니다.

자체 파이프라인에서 VSDX 변환이 필요하다면: 이 기능은 LayerBack이 제공하며, 다이어그램 이미지를 VSDX로 변환하는 전용 REST API가 있습니다. LayerBack API 문서를 참고하세요.