이미지 변환

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

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/conversions",
        headers={"Authorization": f"Bearer

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