LogoLogoAPI 문서
LogoLogoAPI 문서
홈페이지
개요인증과 멱등성이미지 생성이미지 편집이미지 변환차트 생성작업과 제한 대기크레딧오류요청 제한과 동시 실행API 변경 내역
API 문서

이미지 변환

이미지를 SVG, PPTX, PNG, PDF, TIFF로 변환하기

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

폼 필드

필드타입필수기본값규칙
imagefile예—PNG, JPEG, WebP. 최대 10 MiB, 디코딩 후 4,000만 픽셀까지
formatstring예—svg, pptx, png, pdf, tiff
vector_modestring아니요editable_textSVG 전용
dpistring아니요300300, 600, 1000. PNG, PDF, TIFF 전용

두 가지 SVG 모드

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

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

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

다른 형식과 크레딧

이미지 편집

업로드한 이미지를 자연어 지시로 편집하기

차트 생성

데이터 표에서 논문용 차트 생성

목차

폼 필드
두 가지 SVG 모드
다른 형식과 크레딧
cURL: 텍스트 편집 가능한 SVG
JavaScript
Python
VSDX (Visio)
형식옵션크레딧
pptx—10
png, pdf, tiffdpi=3005
png, pdf, tiffdpi=60010
png, pdf, tiffdpi=100015

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 문서를 참고하세요.